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1. INTRODUCTION 


MONARCH is a batch-oriented operating system that al- 
lows batched assemblies, compilations, and executions, 
The MONARCH system is available to users of SDS 9300 
Computers and of SDS 900 Series Computers. MONARCH 


offers three distinct advantages: 


1, Reduced operator intervention increases operational 
reliability. 


2. All control messages are recorded at the typewriter 
for visual verification and permanent logging. 


3. Batch processing capability reduces throughput time. 


MONARCH allows batch processing to proceed without 
the operator having to set up processing parameters or 
select input/output devices. Use of appropriate control 
cards preceding the program permits intermixing and un- 
interrupted processing of assemblies, compilations, and 
executions, Printouts of control and error messages are 
made available during processing, and the operator is 
concerned only with setting up of tapes, loading of cards, 
etc, Ifa program fails, the operator inspects the hard 
copy of control information and makes necessary adjust- 


ments in input/output assignments, tape designations, etc. 


A certain portion of MONARCH — called the Resident — 
remains in main memory at all times. The resident in- 
cludes the MONARCH Bootstrap (to load the MONARCH 
operating system), the Unit Assignment Table (UAT), er- 
ror and job switches, and memory dump routines. The 
MONARCH operating system does not remain in core dur- 
ing the execution of programs; only the resident portion 
is there. MONARCH is reloaded as needed between jobs. 


The major portion of the MONARCH operating system is 
the Monitor (see Section 3). The monitor accepts con- 
trol information from many input media, assigns periph- 
eral equipment as requested, and loads and executes 
specified standard system routines. The control mes- 
sages must precede the program to be processed. In this 
manner, batch processing proceeds free from operator 
intervention and may involve the consecutive process- 
ing of programs from different media. 


During all operations, a portion of MONARCH resident 
in main memory retains a record of input/output assign- 
ments and contains the bootstrap. When called, the 
bootstrap loads a short program (Bootstrap Loader) which 
in turn loads the MONARCH loader. The MONARCH 
loader can bring any of the following routines into core 
from the system tape: 


1. The META-SYMBOL Assembler (900 Series only). 
2. The SYMBOL Assembler. 


3. The META-SYMBOL Loader (loads binary object pro- 
grams produced by META-SYMBOL and SYMBOL). 


The FORTRAN II Compiler (900 Series only). 


5. The FORTRAN Loader (loads object program pro- 
duced by the FORTRAN compiler, necessary sub- 
routines from the FORTRAN Library, and the 
FORTRAN Run-Time package. 900 Series only). 


6. The ALGOL Compiler (not part of the standard 
MONARCH system, but available upon request). 


7. The ALGOL Loader (loads object programs produced 
by ALGOL; provided upon request for the ALGOL 
compiler). 


8. The Update Routine (allows modifications and up- 
dating of the MONARCH system tape). 


The library and utility routines, provided with the system 
or added by the user to the system tape, are also brought 
into core by the loader. 


OPERATING ENVIRONMENT 


The operating environment in which this system is to func- 
tion is given below. The appropriate interrupt and data 
transmission facilities are assumed. 


MONARCH 


The MONARCH system requires for its use the following 
minimum configuration of computer equipment: 


1. An SDS 9300 Computer or an SDS 900 Series Com- 
puter system with at least 8192 words of core memory. 


2. Acconsole typewriter to be used by the system to 
communicate with the console operator. 


3. Two or more on-line magnetic tape units. The sys- 
tem tape is on a magnetic tape unit. 


4. One or more of the following: 


card reader/punch 
paper tape reader/punch 
line printer 


META-SYMBOL/SYMBOL 
META-SYMBOL requires 12, 288 words of core memory; 


its requirements for input/output devices are the same 
as those for MONARCH. SYMBOL operates on the 
minimum configuration required by MONARCH. 


If both the encoded and symbolic input are on the same 
device, an additional magnetic tape or MAGPAK is 
required by META-SYMBOL. The same requirement is 
true if either the symbolic or encoded input is to be read 
from magnetic tape. 


"A MAGPAK may be used in place of two magnetic tape 


units. 


FORTRAN II 


FORTRAN II operates on the minimum configuration re- 
quired by MONARCH. 


ALGOL 
dient 


In addition to the minimum MONARCH configuration, 
ALGOL requires one output device. That is, ALGOL 
must have a device for binary output and one (a line 
printer) for output listing. 


FUNCTIONS OF MONARCH 


The operating system is a basic program execution pack- 
age which provides the following functions: 


1, Loading and execution of standard system routines, 
For example: 
a, FORTRAN compilation. 
b. META-SYMBOL assembly. 
c. Punched card-to-magnetic tape conversion, 
d. MONARCH system updating. 

2. Loading and execution of previously compiled or 


assembled programs for checkout or production runs. 
For example: 


a, Runa previously compiled ALGOL program, 


b. Runa program consisting of several previously 
compiled subprograms and a previously com- 
piled FORTRAN main program. 


3. Combined assembly, loading, and execution of pro- 


grams for checkout or production runs, For example: 


a, Compile-and-go execution of FORTRAN pro- 
grams, 


b, Assemble-and-go execution of symbolic pro- 
grams, 


4, Combinations of the above functions. In the follow- 
ing examples the phrases "job stack" and "batched 
job stack" refer to the collection of control infor- 
mation, programs, and data which are to be pro- 
cessed under control of the MONARCH monitor 
routine, For example: 


a, A series of META-SYMBOL assemblies. 


b, Several META-SYMBOL assemblies intermixed 
with one or more META-SYMBOL object pro- 
grams to be assembled and then executed. 


c. A mixed batch requiring that any or all 
MONARCH functions be carried out in an 


arbitrary sequence determined by their order in 
the batched job stack. 


5. Loading of standard input/output routines prior to 
loading and executing previously assembled pro- 
grams, so that these standard routines can be exe- 
cuted upon request from the program being run, 
For example: 


a, Loading standard input/output routines from the 
system tape, 


b. Loading a conversion routine or trigonometric 
function routine from the MONARCH library. 


HOW MONARCH PERFORMS ITS FUNCTIONS 


The MONARCH operating system performs its functions 
between jobs and does not exercise control over the ex- 
ecution of a program once that program has been loaded 
and control has been transferred to it. These functions are 
indicated to MONARCH via control messages, 


Upon request, MONARCH loads a program and then relin- 
quishes control of the computer and its associated periph- 
eral equipment to the program, The only possible way 
MONARCH can regain control of the computer is if 
MONARCH is reloaded from the system tape. This may 
be done manually by the console operator or under pro- 
gram control by the program being executed. 


SALIENT MONARCH FEATURES 
The salient features of MONARCH are: 


The system minimizes the amount of manual interven- 
tion required to execute a succession of independent 
or related programs on the computer. 


Core memory requirements for the monitor routine are 
minimized during program execution. That is, the 
monitor performs its functions between program exe- 
cutions, and MONARCH holds only those instructions 
and data required for continuity of operation during 
program execution. 


The amount of control information which must be 
furnished to the monitor and the system routines is 
held to a minimum, 


The control information for all system functions is 
presented in a consistent and straightforward manner. 


Insertion and deletion of routines from the system are 
accomplished via a simple update routine, 


Routines to be added to the system are introduced in 
the standard format used for assembly program output. 
That is, almost any program which can be assembled 
by SYMBOL or META-SYMBOL can be incorporated 
into this operating system as a standard system routine, 


2. MONARCH CONTROL MESSAGES AND FUNCTIONS 


When the MONARCH system is loaded, the monitor 
takes control of the computer and obtains the first item 
of control information from the console typewriter, This 
item may be any legal control message. With a C con- 
trol message, the operator may specify that future con- 
trol messages are to be obtained from other input media, 
Control messages may be entered through the following 
input media: 


console typewriter 
punched cards via an on-line card reader 
punched paper tape via a paper tape reader 


magnetic tape via a magnetic tape unit (other than 
the one on which the system tape is mounted) 


When the monitor obtains a control message from a medi- 
um other than the typewriter, it types the message be- 
fore executing the function requested. (The operator 
may direct the monitor to print the control message on 
an on-line printer, See "Operating Procedures," Sec- 
tion 6.) In this way the monitor informs the console op- 
erator of the functions being performed under its control 
and maintains a written record of such functions. The 
monitor tells the operator that a given function is com- 
pleted by typing the next control message or by request- 
ing the next one from the typewriter. 


SYNTAX OF CONTROL MESSAGES 


Regardless of which device the monitor accesses for con- 
trol information, the format of the messages is the same: 


Af, 
or 
AF Py Por veer Pee 


A (1 character) indicates the beginning of a message. 


f (1 to 8 alphanumeric characters) is a mnemonic con- 
trol function code, 


A. indicates a space. These symbols are used to indi- 
cate the minimum number of spaces which must sep- 
arate the function code and the first parameter. 


Py (1 sis 24) is a symbolic, numeric, or literal para- 
meter that provides necessary control information 
related to the control function (f). For example, a 
request for the system loader to load a program 
must indicate the intitial load relocation bias for 
the program that is to be loaded, A maximum of 24 
parameters may be specified in one control message, 


A separator, Acceptable separators are 


r=><$[ J*/()A'@ 


(1 character) indicates the logical end of message. 
The physical end of message is indicated by the end 
of record in the case of magnetic tape and cards or 
by a carriage return in the case of paper tape and 
typewriter. The logical end of message is required 
only when comments are included. 


Regardless of the length of the record containing a con- 
trol message, the routine that scans control messages ex- 
amines only the first 72 characters (18 words) of the 
record. Therefore, the period indicating the end of the 
message must occur prior to the 73rd character of the 
record, 


The first character of a control message is a delta (A). 
This character and the function code may be contiguous 
or may be separated by one or more spaces. Whenthe 
function does not require a parameter list, the function 
code is followed by a period; otherwise, a space sepa~ 
rates the parameter list from the function code. 


Various control messages require different numbers of 
parameters. If more than one parameter is required, all 
but the last must be followed by a separator; the last one 
is followed by a period. 


CONTROL MESSAGE PARAMETERS 


The monitor converts parameters in a MONARCH control 
message into a standard internal form. Except for literals 
(see below), it represents parameters internally as single- 
precision, 24-bit, binary values. Hence, the "value" 
of a parameter is its internal representation as a binary 
quantity or bit pattern, and it is the "value" of a para- 
meter that is ultimately examined by the subroutine in 
the monitor which processes the specific function code. 
This method of parameter conversion usually allows many 
ways of representing a given value externally. For ex- 
ample, the control message parameters '000A' (literal 
parameter) and MT1W (symbolic parameter) have the fol- 
lowing internal representations or values: 


‘000A' = 00000021 
MTIW = 00203611 


which could be entered as numeric parameters. 
NUMERIC PARAMETERS 


A numeric parameter may be written as: 


1. An octal integer, consisting of up to nine octal dig- 
its, the first of which must be zero. An octal in- 
teger may be preceded by an algebraic sign: 


047, +062, -0, 0, 077777777, -032154767 


OO 


2. A decimal integer, consisting of up to eight deci- 
mal digits the first of which must not be zero. A 
decimal integer may be preceded by an algebraic 
sign: 


9, +532, -0, +21657899, -31579988 


The first digit of an octal integer must be zero in order 
for MONARCH to distinguish it from a decimal integer. 


Unsigned octal parameters must have values less than 
224. signed octal parameters and all decimal parameters 
must be less than 223, If the number of digits in a num- 
ber exceeds the applicable limit, the least significant 
digits are truncated. 


Regardless of the form used, the parameter is represented 
internally as a single-precision, signed, binary integer. 


LITERAL PARAMETERS 


A literal parameter consists of up to eight alphanumeric 
characters ericloted in single quotation marks (SDS inter- 
nal code of 14).' Any legal character (see Appendix H) 
except a quotation mark may be written as a literal: 


1. A single-precision literal consists of up to 4 charac- 
ters: 
"AT TA BT TRA 
2. A double-precision literal consists of up to 8 char- 
acters: 


'ABC' 'LITERAL' 'ALPHA777' 'START:3.' 


A literal parameter is represented internally as a left- 
justified string of internal character codes (six bits each). 
A single-precision literal is stored inone computer word. 
A double-precision literal is stored in two words; 


‘ABC DEFGH' is stored in a and a + 1 as 


(a) = 21222324 
(a+1) = 25262730 


Spaces (internal code of 60) are used to fill any unspec- 
ified character positions. For example: 


'ABC' is represented internally as 21222360 


‘ABC DE' is represented internally as 21222324 
25606060 


t : . r 

The single quotation mark is not present on the type- 
writer; however, its internal code (14) is the same as 
that of the typewriter symbol @ (upper case 8). There- 
fore, whenever input is from the typewriter, the symbol 
@ must be used in place of the single quotation mark. 


4 


Double-precision literals are frequently used to desig- 
nate program names for MONARCH search functions. 
(See LOAD control message. ) 


SYMBOLIC PARAMETERS 


Symbolic parameters are symbolic representations of ES 
ameters associated with many of the control messages ex 
plained later in this section. 


Symbolic parameters consist of up to four characters, the 
first of which must be alphabetic and the remaining either 
alphabetic or numeric, Each symbolic parameter has a 
predetermined value (24 bits) which is stored in MON- 
ARCH's table of symbolic parameters. Use of a symbol 
not defined in this table causes the control message in 
which the undefined symbol appeared to be ignored and 
an error message to be typed. 


A octal parameter with the same value may be substi- 
tuted for any symbolic parameter in a control message. 


Listed below are the symbolic parameters used to specify 
input/output devices to the MONARCH system. In this 
list, h specifies the channel and is actually written as W 
or Y for 900 Series Computers or A, B, C, or D for 9300 
Computers. Throughout this manual, references are made 
to the "W" and "Y" buffers; users of the 9300 Computer 
spald substitute the appropriate channel letters in these 


steve ED WE Se et 


places. 


ed £ 
If h is omitted from a parameter, channel! W (or 


A) is assumed. Then specifies the unit number. 


Parameter Definition 

CR designates the card reader where there is 
only one. 

CRnh designates card reader n on channel h. 

CPnh designates card punch n on channel h. 

PRnh designates paper tape reader n on channelh. 

PPnh designates paper tape punch n on channel h. 

TY designates the console typewriter (i.e., 
typewriter 1 on channel W). 

MTnh designates magnetic tape unit n on channel 
h. 

LP designates the line printer (i.e., line 
printer 1 on channel W). 

S designates the system tape (i.e., magnetic 


tape unit 0 on channel W). 


CONTROL MESSAGE FORMATS 


The user directs the operation of the MONARCH system 
via control messages which may be input from the type- 
writer, punched paper tape, or punched cards. Most 
frequently, the control messages are on punched cards 
preceding the user's input card decks. 


System Control 


Utility Functions 


JOB Cc 
ENDJOB SET 
ASSIGN (ONLINE) LABEL 
DISPLAY (SHOW) 
Processor Control POSITION 
REWIND 
METAXXXx! SKIPFILE 
SYMBOL SKIPREC 
FORTRAN BAC KFILE 
ALGOL BAC KREC 
WEOF 
Input Control BOOTLOAD 
CARDTAPE 
FILLSYS EOF 
LOAD 
FORTLOAD System Maintenance 
FORTLINK ———, 
ALGOLOAD UPDATE 
SYSTEM CONTROL 
JOB The JOB control message specifies the 


system is to be in "job mode. " 
A JOB. 


When the system is set to job mode, it resets the proces- 
sor error switch. If an error occurs while a processor 
(such as FORTRAN or META-SYMBOL) is being exe- 
cuted, the processor error switch is set. Then, if the 
operation is a load-and-go (i.e., compile-and-execute 
or assemble-and-execute), the "load" function is not 
honored because of the processor error. If no error oc- 
curs during such a load-and-go operation, the "load" 
function is honored. 


The MONARCH system remains in job mode until an 
ENDJOB control message is encountered. Therefore, 
whenever a job is preceded by a JOB message, it should 
be followed by an ENDJOB (see below) as a courtesy to 
the next user who may not wish to assemble (compile) 
his program in job mode. 


ENDJOB This control message specifies that the 
system is not in job mode. 


AENDJOB. 


"XXXX indicates the name of a set of system PROCs that 
will be used to interpret the program mnemonics during 
the META-SYMBOL assembly (e.g., META920, 
META9I10, META9300, METASPEC, etc.). META9I0 
will assemble on any machine and will produce binary 
output for 910. The set of PROCs is a A2 record with- 
in the scope of the META-SYMBOL logical file. (See 
"System Update Routine" in Section 4 for an explana- 
tion of A2 records. ) 


When an ENDJOB control message is received, MON-= 
ARCH resets the processor error switch and terminates 
job mode. If a processor is being executed in a load- 
and-go operation not in job mode, MONARCH will 
honor the "load" function even if processor errors have 
occurred. 


The system will not return to job mode until it receives 
a JOB control message. 


ASSIGN ASSIGN (or ONLINE) enables the user to 
ONLINE specify the input and output media to be 
used during the current job. 


A ASSIGN L=P,, L=P.,, ep L=Po. 


A ONLINE L=P,, L=P., veep L=Po 


L is a system label. 
P is a symbolic parameter designating the specific device. 


The labels for the standard unit assignments are: 


Label Reference 

SI Symbolic Input oo 

SO Symbolic Output 

BI Binary Input 

BO Binary Output 

EY Encoded Input 

EO Encoded Output 

LO List Output 

UI Update Input 

Xl System Scratch 

x2! System Intermediate Output Scratch 
X3 System Scratch (magnetic tape) 
S System (magnetic tape) 


Labels for Business Language unit assignments are: 


Label Reference 

LO Magnetic Tape Logical Unit 0 
L] Magnetic Tape Logical Unit 1 
L2 Magnetic Tape Logical Unit 2 
ES Magnetic Tape Logical Unit 3 
L4 Magnetic Tape Logical Unit 4 
L5 Magnetic Tape Logical Unit 5 
L6 Magnetic Tape Logical Unit 6 
L7 Magnetic Tape Logical Unit 7 


LCR Card Reader 
LCP Card Punch 
LLP Line Printer 


Note: Ln may be assigned to any physical tape unit; 
i.e., LO=MT2W, L2=MT7W, etc. 


hy ust be assigned to magnetic tape unit 2 (MT2) 
under MAGPAK environment when using META-SYMBOL. 


Nn 


At least one pair of parameters must be given, and a 
maximum of nine pairs is allowed per control message. 
The value of the first parameter must be a label speci- 
fying a unit assignment entry; e.g., SI, LO, etc. The 
value of the second parameter must be a legal periph- 
eral device designation on an existing channel; e.g., 
PRIW, MT3Y, etc. The symbolic parameter associated 
with the peripheral device should be consistent with the 
flow of information; that is, it would be illegal to as- 
sign BI=CP1W (binary input to be entered from the card 
punch). 


Once a unit assignment has been made, it remains in 
effect untila new assignment for that label is*made. 


Examples: 


AASSIGN  BIFCRIW, BO=CP1W. 


This message assigns card reader 1 on the W buffer as 
the binary input device and card punch 1 on the W buf- 
fer as the binary output device. 


AONLINE LCR=CRIW, LLP=LP1W, L2=MT1W. 


This message assigns card reader 1 on the W buffer as 
the card input device, printer 1 on the W buffer as the 
on-line printer, and a second magnetic tape (L2) as 
magnetic tape physical unit 1 on the W buffer. This 
ONLINE statement assigns LCR, LLP, and L2 in BAT 
(Business Language Assignment Table, which is de- 
scribed in Appendix A). 


Note that magnetic tape units are numbered 0 through 
7; all other devices are numbered from 1. 


AASSIGN  BIFCR1IW, S=MTOW, LCR=CRIW. 
AASSIGN = LLP=LPIW, L2=MT IW. 


These messages assign (1) card reader 1 on the W buffer 
as both the binary input device and the card reader for 
a Business Language program, (2) magnetic tape unit 0 
on the W buffer as the system tape, (3) line printer 1 on 
the W buffer as the on-line printer for a Business Lan- ° 
guage program, and (4) the magnetic tape physical unit 
1 on the W buffer as the magnetic tape logical unit 2 
of a Business Language program. 


PROCESSOR CONTROL 


METAXXXX (900 Series only) This control message 
directs MONARCH to load and transfer control to the 
META-SYMBOL assembly system. 


AMETAXXXX = Py, Po, C, CONC, EXCP, SET. 


XXXX specifies which procedure~oriented library 
MONARCH is to load prior to the assembly. Thus, 
the control message may be written as: 


-AMETA920 
AMETA910 


for 920 procedure-oriented library. 


for 910 procedure-oriented library. 


AMETA9300 for 9300 procedure-oriented library. 
AMETAB910 

AMETAB920 for 900 Series special-purpose pro- 
AMETAB93H cedure-oriented library for busi- 


ness data processing. 


The user may provide his own procedure-oriented 
library on the system tape. It must be identified 
by a unique, 4-character name. That name is then 


used in place of XXXX in the METAXXXX control 


message. 


P, specifies type of input: 


Parameter Type of Input 
SI Symbolic Input 
EI Encoded Input 
Po specifies type of output: 
Parameter Type of Output 
SO Symbolic (Source) Output 
EO Encoded Output 
BO Binary Output 
LO List Output 


C (optional) specifies that compatibility mode transla- 
tion of symbolic input is desired. Use of this param- 
eter enables the user to translate a SYMBOL-4 or 
SYMBOL-8 source program into META-SYMBOL 


source form. 


CONC (optional) specifies that a concordance ficting 
is to be produced by META-SYMBOL. 


EXCP (optional) specifies that exceptions are to bemade 
to the concordance listing as designated on META- 
SYMBOL control cards INCLUDE and EXCLUDE. If 
EXCP is present, CONC is not specified. 


SET (optional) specifies that a larger table should be re- 
served for use by the META-SYMBOL preassembler 
to accomplish translation of standard system pro- 
cedures to the user's program format. This parame- 
ter is not necessary when the control message is 
META920, META910, or META9300, but should be 
used with a call for the SDS Business Language. SET 
may also be necessary for future higher order lan- 
guages implemented in META-SYMBOL. 


Concordance listing" refers to a listing of the symbols 
appearing in the META-SYMBOL source program, along 
with a reference to the instructions in which the symbols 
appeared. INCLUDE control cards may be used to limit 
concordance listing to specific symbols only; EXCLUDE 

control cards enumerate specific symbols which are to be 
omitted from the concordance listing. 


N 


The parameters may be listed in any order. One input 
and one output specification must be given. Multiple 
outputs may be requested. 


META-SYMBOL assumes that the necessary input/output 
units have been assigned and that all tape units, except 
scratch tapes, are correctly positioned before MONARCH 
relinquishes control to it. 


Examples: 


AASSIGN SI=CR, LO=LP, S=MTOW, XI=MTIW. 
AMETA920 SI, LO. 


This message sequence requests META-SYMBOL to as- 
semble a symbolic source program and ployee: an assem- 
bly listing as the only output. 


AASSIGN S=MTOW, SIFCR, BO=PPIW, LO=LP. 
AASSIGN X1=MTIW. 
AMETA9300 SI, BO, LO, CONC. 


This sequence requests META-SYMBOL to assemble a 
symbolic source program fromcards and to produce a 
binary output on paper tape and an assembly listing and 
concordance listing on the line printer. 


SYMBOL The SYMBOL control message directs 
MONARCH to load and transfer control to the SYMBOL 
assembly system. 


ASYMBOL Py Po: 
P_ specifies which mnemonic table is to be used dur- 
ing the assembly: 


Parameter Mnemonic Table 
910 910 
920 920 
9300 9300 

PS specifies output data from SYMBOL: 
Parameter Type of Output 
BO Binary Output 
LO List Output 


The parameters may appear in any order. Only one 
mnemonic table (P}) may be specified; at least one out- 
put specification parameter (P5) must be present. Sym- 
bolic input is assumed; therefore, SI should not be present 
as a parameter, but must be ASSIGNed. 


Under MONARCH, SYMBOL has no initial halt to 
ready input, in contrast to previous bootstrap versions. 
Therefore, it is particularly important in the case of 
symbolic input from the paper tape reader (a device 
which has no device ready test) that the paper tape 
be ready at the time SYMBOL is loaded. 

Each SYMBOL control message should be preceded by 
an ASSIGN control message, establishing the desired 


The ASSIGN card is indicative of 
it supplants the typewriter control 


unit assignments. 
device only; i.e., 


message of bootstrap versions and causes SYMBOL to 
load its own preset I/O package. 


Example: 


AASSIGN S=MTOW, SIFCR, LO=LP. 
AASSIGN BO=PP1W, X1=MTIW. 
ASYMBOL 9300, LO, BO. 


This sequence of messages requests a SYMBOL assembly 
from cards, using the 9300 mnemonic table. The output 
from the assembly is to be a program listing on the line 
printer and an object program on punched paper tape. 


FORTRAN (900 Series only) This control message 
causes MONARCH to load and relinquish control to none 
FORTRAN II compiler. 


AFORTRAN Py, P., Pa. 


P. specify type of input and output: 


Parameter Type of Transmission 
SI Symbolic Input 

BO Binary Output 

LO List Output 


Any or all of the parameters may be omitted. Symbolic 
input is always assumed. The presence of the BO param- 
eter causes an object program to be generated. The LO 
parameter causes an output listing to be produced. If no 
I/O unit assignment has been made to the BO or LO de- 
vice, that parameter is ignored. 


Examples: 
AFORTRAN. 


This message requests FORTRAN to compile a source pro- 
gram; no listing or object program is produced; only the 
program allocation, diagnostics, and any erroneous 
source line(s) will be listed. 


AASSIGN S=MTOW, SI=CR, LO=LP, X1=MT1W. 
AFORTRAN BO,LO. 


This sequence of messages requests FORTRAN to compile 
a source program read from cards (SI is assumed if it is 
not present) and to produce an output listing. No object 
program is produced since no BO unit assignment was 
made. 


ALGOL The ALGOL control message causes 
MONARCH to load and transfer control to the ALGOL 


compilerf, 


G 
AALGOL Pi Por Ps. 


"The ALGOL compiler is not part of the standard MON- 
ARCH system, but is available on request. 


P. specify the input/output devices to be used by 
ALGOL. 


Parameter Type of Transmission 
LS List Source 

LO List Object Code 
BO Binary Output 


The parameters may appear in any sequence, and any 

or all may be omitted. ALGOL always reads source in- 
puts from the device previously assigned to SI. When 

a listing of the source program is requested (LS param- 
eter), the listing is produced on the LO device. The LO 
device must be a line printer. When requested to list 
object code (LO parameter), ALGO produces the list 
on the LO device. The BO parameter specifies that 
ALGOL is to produce a binary object program on the 
BO device. 


If no output device is specified and an error occurs dur- 
ing compilation, an error message is produced on the 
console typewriter. 


Note: ALGOL must have a scratch tape available to it 
and will automatically use the magnetic tape 
previously assigned to X1. 


| en Io. 
CAXGM PIE: 
— 


AASSIGN S=MTOW, SI=CR, LO=LP, BO=PP1W., 
AASSIGN X1=MTIW. 
AALGOL LS,LO, BO. 


This sequence of control messages requests the ALGOL 
compiler to read a source program from cards; compile 
it, listing the object and source programs on the line 
printer; and output the binary object program on punched 
paper tape. The magnetic tape unit 1 on the W buffer 

is to be the compiler's scratch tape. 


INPUT CONTROL 


FILLSYS This control message transfers control to 
the monitor's bootstrap routine which will reload the 


MONARCH system. 
AFILLSYS. 


There are no parameters. The message is equivalent to 
executing an unconditional branch to memory location 


00001. 


LOAD The LOAD message directs the MON - 
ARCH loader to load one or more binary object programs. 


ALOAD P,, Py, Pa. 


P, isthe load relocation bias, expressed as a positive oc- 
tal ordecimal integer, for the first (or only) program 


to be loaded. For programs whose load addresses 
and data words are not relocatable (i.e., absolute 
programs), the load relocation bias is ignored. 


P. is the loader options parameter. The options are 
Parameter Interpretation 


STOP Stop after each program is loaded 
(i,e., after each end record is read); 
no symbol table output and no return 
to the routine that called the loader. 
Octal equivalent of the symbolic pa- 
rameter STOP is 10000000. 


GO No halt after processing end record 
with transfer address; no symbol table 
output and no return to the routine 
which called the loader. Octal equiv- 
alent of the symbolic parameter GO 
is 40000000. 


TSte Same as STOP except that the load- 
er's symbol table is output. Octal 
equivalent of the symbolic parameter 


TSTP is 20000001. 


TGO Same as GO except that the loader's 
symbol table is output. Octal equiv- 
alent of the symbolic parameter TGO 


is 60000001. 


If the loader is not requested to output the symbol 
table and unsatisfied Programmed Operator refer- 
ences or definitions occur, an error message and the 
unsatisfied references and/or definitions are typed, 
and MONARCH halts. If these unsatisfied refer- 
ences/definitions will not affect the operation of 
the program, the operator can clear the halt and 
the program will be executed. Otherwise, he can 
take appropriate action. When the loader is re- 
quested to output the symbol table, it produces the 
table on the line printer if Breakpoint 1 is set or on 
the typewriter if Breakpoint 1 is reset. 


P, is an optional parameter that is interpreted as a 
program identification label assumed to occur in 
characters 9 through 16 of a level | MONARCH 
ID record on the current binary input unit. (See 
Appendix B for a description of record formats. ) 


At least one (P}) and at most three parameters must be 
given for the LOAD control message. When parameter 
P3 is present, its value is converted to a left adjusted, 
space-filled, 8-character search key. The monitor 
causes records to be read from the unit assigned for bi- 
nary input (BI) until (1) a level 1 MONARCH ID record, 
with the same name in characters 9 through 16, is ob- 


tained or (2) the last file has been scanned (i. e., until 
a level 1 MONARCH ID record with "SYSEND,," in 


characters 9 through 16 is encountered). Inthe first case, 
control is relinquished to the MONARCH loader that 
processes the input as specified by the first two param- 
eters. In the second instance, a message SEARCH FOR 
SPECIFIED ROUTINE FAILED is typed, and the next 
MONARCH control message is requested. A detailed 
description of the MONARCH loader is given in Sec- 
tion 3. 


Prior to processing a load function, the monitor inter- 
rogates the processor error switch and the job mode 
switch (see JOB control message for an explanation of 
these switches). If both switches are set, the requested 
load function is aborted. An appropriate error message 
(PROCESSOR ERROR ... ) is printed, and typewriter 1 
on the W buffer is selected for input of a control mes- 
sage. 


Examples: 
ALOAD 010000,STOP. 


This message causes the MONARCH loader to load one 
or more programs, beginning in location 10000g. Input 
is from the current BI device, and the loader stops (halts) 
after each program is loaded (i.e., after each end re- 
cord is read). 


ALOAD 2048, TSTP. 


This message causes the MONARCH loader to load one 
or more programs, beginning in location 4000g (204819). 
Input is from the current BI device, and the loader halts 
after each program is loaded (i.e., after each end re- 
cord is read). After loading is completed and prior to 
program execution, the symbol table is output. 


ALOAD 0,TGO, 'FILENAME'. 


This message (input from cards) causes the MONARCH 
loader to find program FILENAME (as a level 1 ID re- 
cord) on the specified BI unit and to load the program 
with 0 relocation (ij. e., as an absolute program). The 
loader's symbol table is output prior to program execu- 
tion. If input is from the typewriter, this message would 
appear as 


ALOAD 0,TGO, @FILENAME@. 


(See discussion on "Literal Parameters. ") 


ALOAD GO. 


This message forces a load relocation bias of 0 and may 
be used to load absolute programs. 


FORTLOAD (900 Series only) The FORTLOAD control 
message causes MONARCH to load and transfer control to 
the FORTRAN loader. The parameters inthe control mes- 
sage specify the mode in which the FORTRAN loader is 

to operate and the input devices from which it isto read. 


APORTEOAD (Pi Pig Pag: tnae) Pe 


P. consists of up to eight parameters that may be given. 
The first three specify the mode in which the FOR- 
TRAN loader is to operate: 


MAP Produce a storage map of the program 
on the console typewriter. 


t 
LMAP Produce a label map on the console 
typewriter. 
t 
LTRA Produce a label trace at execution time. 


These three parameters may appear in any order or 
may be omitted entirely. If they appear, they must 
be the first in the parameter string. The other pa- 
rameters specify which input devices are to be read 
(e.g., X1, BI); at least one input device must be 
specified. Information is loaded from the devices 
in the order they appear in the parameter list. These 
devices must have been assigned and correctly posi- 
tioned before the FORTRAN loader is called. 


The FORTRAN loader automatically loads the previously 
compiled program, which must be on the first input de- 
vice specified by the parameters. When additional in- 
put devices are specified (i.e., in addition to the unit 
from which the program is read), the loader reads from 
these devices only routines that are necessary because of 
unsatisfied references/definitions. However, if the user 
wishes to have the loader load from the additional de- 
vices unconditionally (i.e., regardless of whether or not 
the program references any of the routines read from that 
device), he places the letter U after the appropriate pa- 
rameter. 


Example: 


AASSIGN_BI=MTIW, X1=CRIW. 
AFORTLOAD MAP, LTRA, BI, X1U. 


The FORTRAN loader will read a previously compiled 
FORTRAN program from magnetic tape unit 1 and will 
read, unconditionally, from the card reader. It will 
produce a storage map of the program and a label trace 
as the program is executed. 


FORTLINK The FORTLINK control message causes 
MONARCH to load and transfer control to the FORTRAN 


loader. This message is used only when a link tape is to 


be generated. Linking is discussed in Appendix E. 


AFORTLINK Pir Por Par saint 1 Pos 
P_ is the identification number to be assigned to the 
link about to be written on magnetic tape; may be 


any three decimal digits. 


Pg same as P, for FORTLOAD. 


9 


ro 


"The output resulting from the use of this parameter is 
described in Section 6. 


ALGOLOAD This control message causes MONARCH 
to load and transfer control to the ALGOL loader. The 
parameter is optional. 


AALGOLOAD BI. 


BI (optional) specifies binary object program input. 
The ALGOL loader always reads binary object pro- 
grams from the device previously assigned to BI. 


After loading an ALGOL-compiled object program, the 
ALGOL loader searches the system tape (magnetic tape 
unit 0 on the W buffer) for any referenced library pro- 
grams. 


Examples: 


AASSIGN BI=CR. 
AALGOLOAD. 


This sequence of control messages causes the ALGOL 
loader to load a binary object program from the card 
reader, to load any referenced library programs from 
magnetic tape unit 0, and to transfer control to the 
object program. 


AASSIGN BI=MT2W. 

AALGOLOAD BI. 
These messages cause the ALGOL loader to read a bi- 
nary object program from magnetic tape unit 2. Then, 
the loader reads the system tape, loads the required li- 
brary programs, and transfers control to the object pro- 
gram. 


UTILITY FUNCTIONS 


C The C control message directs MONARCH 
to accept future control messages from a specific input 
device. 


AC P 
Py must be a legal input unit assigned to an existing 

buffer. 

Parameter Definition 

CRnh Designates card reader n on buffer h. 

MTnh Designates magnetic tape unit n on 
buffer h. 

PRnh Designates paper tape reader n on 
buffer h. 

TYnh Designates typewriter n on buffer h. 


Unless a C control message directs otherwise, MONARCH 
automatically accepts control messages from the console 
typewriter (1 on the W buffer). 


Once a C message has been processed, MONARCH im- 
mediately attempts to read a control message from the 
newly assigned device. 


This message assigns paper tape reader 1 on the W buffer 
as the control message input device. 


SET This control message enables the user to 
set the contents of a specified memory location toagiven 
value and is operative only if the MONARCH monitor is 
in control. 


ASET A=V. 
A is any legitimate memory address. 


Vis the value to be stored in location A. (If the 
value exceeds 223-1, the most significant digits 
are stored. ) 


A and V may be expressed as either octal or decimal 
numeric parameters. 


Examples: 
ASET 017=-59. 


This message will cause the contents of memory location 


000178 to be set to 77777705 (-59}9 = -733). 
ASET 64=077777. 


This message will cause the contents of cell 100g (6440) 
to be set to 00077777. 


ASET 0235=001000114. 


This message will cause the instruction BRU 00114 to be 
stored in location 00235g. 


LABEL The LABEL control message enables the 
user to write a level 1 or level 2 MONARCH ID record 
on a magnetic tape. (See Section 4 "System Update 
Routine" for a discussion of MONARCH ID records. ) 


ALABEL P,, Po, P3. 


P, is the value | to indicate a level 1 ID record or the 
value 2 to indicate a level 2 ID record. 


P. is the unit on which the ID record is to be written. 
The value of this parameter must be a legal mag- 
netic tape unit designation on an existing buffer; 
e.g., MT3W to specify magnetic tape unit 3 on 
the W buffer. 


P., is a double-or single-precision literal, used to con- 
struct an 8-charactername. If fewer than eight char- 
acters are given, the name field will contain (trailing) 
spaces in the right-most character positions. 


A level 1 or level 2 MONARCH ID record (indicated by 
the first parameter) is constructed with the name field 
(characters 9 through 16) containing the identifier spec- 
ified as the third parameter. The ID record is then writ- 
ten on the magnetic tape designated by the second 
parameter. An ID record consists of 40 characters (char- 
acters 17 through 40 are blanks) written in binary ("odd" 
parity) mode. 


Example: 


ALABEL 2, MT3W, 'FILENAME'. 


This message will cause MONARCH to write a level 2 
MONARCH ID record on magnetic tape unit 3 on the 
W buffer. Characters 9 through 16 of this record will 
contain FILENAME. 


DISPLAY DISPLAY (or SHOW) allows the user to 
SHOW produce the contents of one or more 
memory locations on the console typewriter and is op- 
erative only if the MONARCH monitor is in control. 


ADISPLAY Py THRU Poe 


ASHOW P THRU Ps 
P_ (required) must be a legitimate memory address. If 
it is the only parameter given, it designates the 
one location whose contents are to be displayed. 
If three parameters (P}, THRU, and P9) are given, 
P1 is the beginning address of the sequential mem- 
ory locations whose contents are to be displayed. 


THRU (optional). When the contents of more than one 
memory location are to be displayed, the second 
parameter of the control message must be the word 


THRU. 


P, (optional). When present, this parameter must be 
a legitimate memory address which is equal to or 
greater than the value of P}. Pg specifies the end- 
ing address of the sequential memory locations 
whose contents are to be displayed. 


After interpreting the parameters, MONARCH converts 
the contents of each designated memory location to oc- 
tal and types each value, together with its octal ad- 
dress on typewriter | on the W buffer. 


Examples: 


If location 037777 contains zero, the message 
ADISPLAY 037777. 
will cause the following to be typed: 
037777 = 00000000 


The message 
ASHOW 0164 THRU 0174. 


will cause the address and contents of each of the 9 
locations specified to be typed. 


POSITION This control message enables a user to 
position a magnetic tape at a given file (identified by a 
MONARCH level 1 ID record only - not a level 2 re- 
cord; ID records are described under "System Update 
Routine" in Section 4). 


APOSITION P,,P 


> 

Py must be a legal magnetic tape unit designation on 
an existing buffer; e.g., MT3W specifies magnetic 
tape unit 3 on the W buffer. 


P, is a literal consisting of up to eight alphanumeric 
characters. Trailing blanks (60g) are supplied if 
fewer than eight characters are given. The value 
of this parameter is used as the search key. 


To position the specified magnetic tape at the desired 
file, the MONARCH Search subroutine reads successive 
records (in a forward direction) until a level 1 MON- 
ARCH ID record is found that contains, in characters 9 
through 16, the given file identification (Po). The tape 
is read in binary ("odd" parity) mode, and the maximum 
ID record length is assumed to be 40 words (160 charac- 
ters). The search is terminated as follows: 


1. If characters 9 through 16 of a level 1 ID record 
contain the file ID specified as the second param- 
eter, control is returned to MONARCH to obtain 
the next control message. The tape will be posi- 
tioned in the inter-record gap which follows the 
ID record. 


2. If characters 9 through 16 of a level 1 ID record 
contain SYSEND,j, a message is typed indicating 
that the specified file was not found. Then control 
is returned to MONARCH to obtain the next con- 
trol message. 


3. If characters 9 through 16 of a level 1 ID record 
contain neither SYSENDAA nor the specified file 
ID, the search is continued until either condition | 
or condition 2 is satisfied or until the computer op- 
erator intervenes. 


Example: 
APOSITION MT2W, 'FILEIDEN', 


Input from cards, this message will cause MONARCH to 
position magnetic tape unit 2 on the W buffer in front of 
the first record following the level 1 MONARCH ID re- 
cord that contains FILEIDEN in characters 9 through 16. 
If input is from the typewriter, this message would ap- 
pear as 


APOSITION MT2W, GFILEIDENG@. 
(See discussion on "Literal Parameters. ") 


REWIND The REWIND control message causes 
MONARCH to rewind the specified magnetic tape unit. 


AREWIND P. 


P. must be a legal magnetic tape unit designation on 
an existing buffer; e.g., MIT3W. 


Example: 
The message 
AREWIND MTOW. 


will cause MONARCH to rewind magnetic tape unit 0 
on the W buffer. 


SKIPFILE These control messages cause MONARCH 
SKIPREC to skip files or records in a forward di- 
rection on a specified magnetic tape unit. (See also, 
BACKFILE and BACKREC.) The magnetic tape unit and 
number of files or records to be skipped are specified by 
the control message parameters. 


ASKIPFILE P., Po 


ASKIPREC Pi, Po. (skip records) 


(skip files) 


P, must be a legal magnetic tape unit designation on 
an existing buffer; e.g., MT2W designates mag- 
netic tape unit 2 on the W buffer. 


P, specifies the number of files or records to be 
skipped. 


After interpreting the parameters, MONARCH moves 
the specified magnetic tape forward the indicated num- 
ber of files or records. If an EOF mark is encountered 
during a skip record process, the tape will stop. Thus, 
the tape will be positioned immediately after the EOF. 


Examples: 
ASKIPFILE MT1W, 5. 
This message causes MONARCH to skip forward 5 files 


on magnetic tape unit 1 on the W buffer. 


12 


ASKIPREC MT3Y, 10. 


This message causes MONARCH to skip forward 10 (12g) 


records on magnetic tape unit 3 on the Y buffer. 


BACKFILE These control messages have a function 
BACKREC similar to that of SKIPFILE and SKIPREC; 
however, with BACKFILE and BACKREC the magnetic 
tape is moved in a backward direction. 

ABACKFILE Pay Pas 
ABACKREC Pir Po 


P} and P» have the same interpretation as for SKIPFILE 
and SKIPREC. 


After interpreting the parameters, MONARCH moves the 
specified magnetic tape backward the indicated number 

of files or records. If an EOF mark is encountered dur- 

ing a skip record process, the tape will stop. Thus, the 

tape will be positioned before the EOF mark. 


Examples: 
ABACKFILE MTOY, 12. 


This message causes MONARCH to skip backward 1219 
(14g) files on magnetic tape unit 0 on the Y buffer. 


ABACKREC MT2W,3. 


This message causes MONARCH to skip backward 3 re- 
cords on magnetic tape unit 2 on the W buffer. 


WEOF The WEOF control message directs 
MONARCH to write an end-of-file (EOF) mark on the 
specified tape. 


AWEOF P 

P, must be (1) a legal magnetic tape unit designation 
on an existing buffer or (2) a legal paper tape punch 
unit designation on an existing buffer. That is, Py 
may take the form MTub or PPxb, where u must be 
within the range OS us7, bis Wor Y, and x is 1 
or 2. 


Examples: 
AWEOF MT3W. 
This message causes MONARCH to write an end-of-file 


mark (17000000) on magnetic tape unit 3 on the W buf- 
fer. 


AWEOF PPIY. 


This message causes a special end-of-file mark (17170000) 
to be punched on paper tape unit 1 on the Y buffer. (This 


is to facilitate the loading of a FORTRAN-compiled 
program into the FORTRAN library on the system tape. 
See Section 4, "System Update Routine. ") 


BOOTLOAD This control message directs MONARCH 
to produce an absolute or relocatable bootstrap’ on paper 
tape or magnetic tape as specified. 


ABOOTLOAD P,P... 


P. must be ABS for absolute or REL for relocatable. 


P. must specify the magnetic tape unit or paper tape 
unit on which the bootstrap is to be produced; e.g., 
MT2W, PPI1W for 900 series; or MT2A, PPIA for 
9300. 


MONARCH interprets the control message and produces 
the requested bootstrap on the specified tape. These 
bootstraps can load programs assembled by SYMBOL or 
META-SYMBOL. Although the bootstrap may be pro- 
duced on any paper tape or magnetic tape unit, it can 
be read from only paper tape unit 1 on the W buffer or 
magnetic tape unit 0 on the W buffer on 900 Series 
Computers. Substitute corresponding A channel for 
9300 Computers. 


Examples: 
ABOOTLOAD ABS, PPIW. 


This control message directs MONARCH to punch an 
absolute bootstrap on paper tape punch | on the W 
buffer. 


ABOOTLOAD REL, PP2W. 


This message causes MONARCH to punch a relocatable 
~ bootstrap on paper tape punch 2 onthe W buffer. 


ABOOTLOAD ABS, MTIW. 


This message directs MONARCH to write an absolute 
bootstrap on magnetic tape unit 1 on the W buffer. To 
load the object program, dial the tape unit number to 
zero and execute a fill from magnetic tape: 


Set (X1) = -7 (77777771) 

EOM 03610 (0 02 03610) 
WIM 2 (0 32 00002) 
BRU | (0 01 00001) 


Descriptions of the bootstrap routines are available from 
the SDS Program Library: 900 Series Paper Tape Abso- 
lute Bootstrap, catalog number 020020; 900 Series Paper 
Tape Relocatable Bootstrap, catalog number 000019; 
9300 Paper Tape Relocatable Bootstrap, catalog number 
600001. The magnetic tape bootstrap routines are modi- 
fied versions of the MONARCH boostrap loader. 


Set the contents of register A to 0 32 00002. 
Set the contents of register C to 0 35 00001. 
Set the RUN-IDLE-STEP switch to STEP. 
Press START. 


Press FILL switch, which sets (X1) to -7. If program 
is relocatable, set (A) = relocation bias. 


Set the contents of register C to 0 02 03610. 
Set the RUN-IDLE-STEP switch to RUN. 


Note: To load the 925/930/9300 magnetic tape boot- 
strap, execute a magnetic tape FILL procedure. 
For 9300 computers, use appropriate channel la- 
bel (i.e., A, B, C, or D). 


CARDTAPE The CARDTAPE control message causes 
MONARCH to select the designated card reader, to 
read cards in symbolic, encoded, binary, MONARCH 
identification, and control message formats and to write 
them on the magnetic tape specified. 
ACARDTAPE Pir Po. 
P, must be a legal card reader designation on an exist- 
ing buffer; e.g., CRIW. This parameter specifies 
the card unit from which the cards are to be read. 


P. must be a legal magnetic tape unit designation on 
an existing buffer; e.g., MT2W. This parameter 

specifies the tape unit on which the information is 
to be written. 


Cards are read from the card reader specified and are 
written on the designated magnetic tape. Binary, en- 
coded, MONARCH identification, and control cards 
are written in binary; all other cards are written in 
binary-coded decimal (BCD). When a AEOF card is 
read or a card reader end-of-file is detected, an end- 
of-file (EOF) mark is written on the magnetic tape, and 
control is returned to MONARCH. If successive files 
are to be written on tape, each file must be preceded by 
a CARDTAPE control message, including the necessary 
parameters. 


Example: 


The control message 
ACARDTAPE CRIW, MT3W. 


directs MONARCH to read cards from card reader 1 on 
the W buffer and to write them on magnetic tape unit 3 
on the W buffer. When the read is completed, an EOF 


mark will be written on the magnetic tape. 


EOF The EOF contro! message signifies the 
end of a logical file and transfers control to MONARCH 


AEOF, 


oneal 
ie) 


There are no parameters for this message. It is recognized 
by the "action" routine that processes the CARD TAPE con- 
trol message (see Section 3 for explanation of action 
routines. ) The EOF message is also recognized by the 
FORTRAN and META-SYMBOL processors. 


SYSTEM MAINTENANCE 


UPDATE This control message causes MONARCH 
to load the System Update Routine and to transfer con- 


; 
tro! to it. 


AUPDATE Py. 


P (optional). When present, this parameter indicates 
blocking mode operation and must be within the 
range 


Alig < P < 25646 


The absence of the parameter indicates norma 
operation. 


mode 


See Section 4 for a description of the update routine, its 
operating modes, and the control messages required for 
its use. 


3. THE MONARCH SYSTEM 


MONITOR 


The major portion of the MONARCH system is the moni- 
tor routine. This routine accepts control information 
which, among other things, may include a request to 
load and execute a specified standard system routine. 
The monitor performs its function between jobs and does 
not exercise control over the execution of a program 
once the program has been loaded and control has been 
transferred to it. 


The monitor consists of a number of subroutines. One of 
these subroutines is the system tape search routine. This 
is the subroutine that searches the system tape for a 
given routine name (see POSITION control message). 
Another monitor subroutine analyzes and interprets the 
contents of the control messages that convey control in- 
formation to the monitor. It also converts the param- 
eters in control messages to standard internal form. 


Other subroutines, called "action" subroutines, perform 
the functions associated with specific control messages. 
For example, the action subroutine associated with the 
ASSIGN message modifies the contents of MONARCH's 
unit assignment table, based on the values of the pa- 
rameters in the ASSIGN message. Another action sub- 
routine, associated with the LOAD message, controls 
the searching of tape files for specified object programs 
and calls on the MONARCH loader to load these object 
programs. Additional subroutines employed by the mon- 
itor include those which perform input/output for MON- 
ARCH. 


Part of the monitor, called the resident, remains in core 
memory during program execution. The resident consists of 
the monitor bootstrap routine (QBOOT), the unit assign- 
ment table, the error and job switches, the octal dump rou- 
tine (QDUMP), and the symbol table dump driver (see 
Appendix B fora complete description of memory layout). 
The resident occupies the last 132g locations in memory. 
Memory space occupied by the remaining subroutines com- 
prising the monitor and by other routines in the MONARCH 
system (such as the MONARCH loader) is available foruse 
by the program being executed. The last available location 
in core isone cell below QDUMP (however, the term 
QDUMP-1 is illegal in META-SYMBOL language). 


STANDARD SYSTEM ROUTINES 


Standard system routines are those that exist on a MON- 
ARCH system tape and that can be loaded and executed 
by supplying an appropriate control message to the 
MONARCH monitor. Some existing system routines, as 
well as the necessary and desirable characteristics of 
potential system routines, are described below. 


Certain of the standard system routines must be present 
on any MONARCH system tape. These programs com- 
prise the minimum operable MONARCH system: 


1. The monitor. This routine is the heart of the opera- 
ting system. 


2. The MONARCH loader. The monitor uses this rou~ 
tine to load standard system routines from the sys- 
tem tape and to load previously assembled programs 
presented by the MONARCH user. The MONARCH 


loader is described later in this section. 


3. The MONARCH bootstrap loader. This routine per- 
forms the function of loading the MONARCH loader 
and the MONARCH monitor and precedes all other 
system routines on a MONARCH system tape. This 
is the routine that is called in for execution by the 


monitor bootstrap (QBOOT). 


Certain system routines, while not essential for a mini- 
mum MONARCH system, enhance the usefulness and 
flexibility of any MONARCH system. 


1. The MONARCH system update routine. With this 
routine, the user can create new MONARCH system 
tapes or update existing system tapes. This routine 
is described in Section 4. 


2. The standard input/output subroutines. These sub- 
routines are used by other system routines to per- 
form required input/output functions. These I/O 
subroutines, which can be selectively loaded on an 
"as needed" basis, are 


Line Printer Output Subroutine (PRINT) 
Magnetic Tape Input/Output Subroutine (MTAPE) 
Card Read/Punch Subroutine (CDRP) 


Paper Tape/Typewriter Input/Output Subroutine 
(PTYIO) 


The action subroutines for a given system routine ex- 
amine the parameters of the control message and the 
unit address codes of those MONARCH unit assign- 
ment table entries that represent input/output func- 
tions to be performed and, finally, direct the load- 
ing of the I/O subroutines needed. The MONARCH 
update routine relies on this feature to provide the 
input/output subroutines needed to perform a speci- 
fic update run. 


3. The META-SYMBOL assembly system. Presence of 
this routine provides a powerful and flexible assem- 
bly language and processor. 


— 
On 


4, The FORTRAN II system. Presence of these routines 
enables the MONARCH user to use the full capa- 
bilities of the SDS 900 Series FORTRAN II Compiler, 
Loader, and Run-Time Package. 

5. The ALGOL system. This system, which is availa- 

ble on request, operates on both SDS 900 Series 


and the 9300 Computers. It includes the ALGOL 
Compiler, Loader, and Run-Time package. 


See "Automatic Selective Loading from the MONARCH 
Library" at the end of this section for a description of 
the MONARCH library, another optional MONARCH 


feature that can contribute greatly to the usefulness and 
efficiency of a MONARCH system. 


MONARCH is designed to facilitate the incorporation 
of additional system routines as needed. The user can 
include in a MONARCH system any routine that meets 
the following requirements: 


1. The routine must exist (on cards or paper tape) in 
SDS standard binary language. 


2. Its memory space requirements must be such that it 
(or a special loader which precedes it on the system 


tape) can be loaded by the MONARCH loader. 


3. It must be written in a manner that is consistent 
with run termination as described in the paragraph, 
"Termination of a Run, " below. 


Certain other characteristics, while not essential, ease 
the job of incorporating new system routines and render 
these routines more useful in the MONARCH environ- 
ment: 


1. The routine should be one that can be assembled 
as a series of one or more relocatable programs by 


SYMBOL or META-SYMBOL. 


2. It should be written in such a way that any "param- 
eters" required for its initialization can be easily 
supplied in the form of MONARCH control message 
parameters (see "Control Message Parameters" in 
Section 2). 


3. The routine should be written to obtain unit and 
channel assignments for all its input/output func- 
tions from the MONARCH unit assignment table. 


TERMINATION OF A RUN 


When a program being executed under MONARCH 
reaches a normal conclusion, it should transfer control 
to the monitor bootstrap in core memory (location 1) 
rather than execute a HALT instruction; the monitor boot- 
strap initiates the reloading of the MONARCH loader 
and the MONARCH monitor. The monitor then attempts 
to read a new control message from the current control 
medium and in this way proceeds to the next job with- 
out the necessity for manual intervention. The monitor 


bootstrap is part of the MONARCH resident. 
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When a program being executed under MONARCH de- 
tects a program or computer error that makes it inadvis- 
able to continue program execution, it should give what- 
ever error indication is suitable and transfer control to 
the monitor bootstrap. This routine initiates the reload- 
ing of the MONARCH loader and MONARCH monitor, 
and then the console operator can decide whether or not 
to continue with the next job or function in a batched 
job stack or to take some alternative action. 


When the console operator decides that a program being 
executed has halted inadvertently or is otherwise mal- 
functioning, he can stop the program, clear the registers 
and restart by manually transferring control to a restart 
location in the monitor bootstrap. The monitor bootstrap 
initiates the reloading of the system, and then the moni- 
tor attempts to obtain the next control message. At this 
point, the operator can decide whether or not to continue 
with the next job in the batched job stack or to execute 
some other system function. 


The normal restart procedure is to execute a branch to 
location 1. Location 1 normally contains an uncondi- 
tional branch to the monitor bootstrap in upper memory. 
The routine that is loaded by the monitor bootstrap is 

the MONARCH bootstrap loader, which precedes all 
other routines on the system tape. The MONARCH boot- 
strap loader in turn loads the MONARCH loader and the 
MONARCH monitor. 


LOADER 


The primary function of this routine is to load the user's 
object programs. It is also called upon by the MONARCH 
monitor to load from the system tape standard system 
routines such as META-SYMBOL, the system update rou- 
tine, etc. The loader (including QDUMP, QBOOT, 

and UAT) occupies upper core. 


The loader is capable of loading binary object programs 
in the format produced by SYMBOL and META-SYMBOL. 
A series of programs to be loaded may be absolute or re- 
locatable and may contain: 


1. External label references and/or definitions. 


2. External Programmed Operator (POP) references 
and/or definitions . 


3. Blank COMMON references and a definition. 


Blank COMMON references should be preceded by a 
blank COMMON definition, but external references 


"The capability of handling POP items is not included in 
9300 MONARCH loader since the 9300 does not have 
Programmed Operators. All other capabilities of the 
900 Series MONARCH loader are included in 9300 
MONARCH loader. 


ee vere ey ‘for all I/O operations. 


and definitions (label or POP) need not be supplied in 
any particular order. 


The term "program" in this description of the MONARCH 


loader means a sequence of: 
1. . One or more data records (record type 0) and/or 


2. One or more external references or definition re- 
cords (record type 1) and/or 


3. One or more Programmed Operator references or 
definition records (record type 2) and 


4, Anend record (record type 3) with or without a 
transfer address. 


See Appendix F, "SDS Standard Binary Language," for 

a description of the record formats accepted by this load- 
er. Note that the MONARCH loader does not accept 
labeled COMMON definitions or references (record 

type 2, item types 1 and 3) and treats labeled COMMON 


references as format errors. 


The last (or only) program in a series of programs to be 
loaded must have an end record (type 3) with a trans- 
fer address, and all programs preceding it must have 
end records without transfer addresses. 


If there are unsatisfied label or POP references at the 
time the end record with a transfer address is encoun- 
tered, the loader attempts to satisfy these by selectively 
loading the appropriate subroutines from the MONARCH 
library. If this is unsuccessful , the loader automatically 
outputs (on typewriter 1 on the W buffer if Breakpoint 1 
is reset or on line printer 1 on the W buffer if Break- 
point | is set) the unsatisfied labels or POP references. 
Following this information, the loaderoutputs the symbol 
table if requested to do so (see LOAD control message 
in Section 2), Then the computer halts. After deter- 
mining whether the missing definitions will affect the 
run, the user may elect to execute the program by simply 
clearing the halt (i.e., move the RUN-IDLE-STEP switch 
from RUN to IDLE to RUN) or to abort the run by trans- 
ferring manually to the bootstrap (i.e., to location 1). 


Programs may be loaded from punched card, magnetic 


tape, or paper.tape units attached to ether the WorY 
buffer. (fKe input/outpui subroutines within fhe 900 ~ 


a _Series/MONARCHtoaderuse_neithe neither interrupts nor > 


~ The 9300 I/O handlers use interlace and _ 
Any I/O operation 
performed by 9300 MONARCH that does not use the 

1/O handlers does not use interrupts. Reading and search- 
ing of the binary input medium by the 9300 MONARCH 
loader uses interlace but not interrupts. The symbol! 
table typeout routine, the line printer octal dump routine, 
and the punching of the absolute bootstrap on paper tape 
do not use interrupts or interlace. 


interlace.: 


UNIT ASSIGNMENT REQUIREMENTS 


When a LOAD control message (see Section 2 for a de- 
tailed description of this message) is issued to MONARCH 
the unit assignment table’ is assumed to contain the fol- 
lowing information: 


1. QMSG contains the unit and channel designation 
for the peripheral device that is to furnish MON- 
ARCH control messages. (QMSG is set by the C 
control message. ) 


2. QBINI contains the unit and channel designation 
for the peripheral device that is to furnish input 
(programs) to the loader. The unit must be a card 
reader, a magnetic tape unit, or a paper tape 
reader. 


The following sequence of MONARCH control messages 
illustrates one means of setting the unit assignment table 
and requesting the MONARCH loader to load one or 


more programs: 


AC TYIW. 
AASSIGN _BI=CRIW. 
AENDJOB. 

ALOAD 010000, GO. 


The control messages are to be input from typewriter | 
on the W buffer, and the binary input is to be read from 
card reader 1 on the W buffer. The loader is to load the 
first (or only) program with a relocation bias of 10000g 
and is to transfer control to the location specified on the 
END record of the last program without stopping and 
without a symbol table printout. If any references are 
unsatisfied, a list of the unsatisfied references is typed 
on typewriter 1 on the W buffer. Then the loader halts. 
To continue, the operator clears the halt. 


STORAGE ALLOCATION 


When the MONARCH system is loaded, the MONARCH 
loader is stored in upper core, occupying locations 
X5441g through X7777g (X = 1, 2, or 3). The loader's 
symbol table (external label definition entries) initially 
occupies memory from X5440g through X5276g. As each 
additional external symbol is inserted in the symbol table, 
it occupies the three memory locations immediately be- 
low the last symbol table entry. Thus, the loader and 
its symbol table occupy that amount of upper core re- 
quired by the loader routine itself and the external sym- 
bol entries. 


At the time a request to load a user's program is initiated, 


the loader symbol table contains external table defini- 
tion entries that allow external references to locations 


t ‘ : ‘ 
The external labels mentioned here are discussed in 


Appendix A, "The MONARCH Unit Assignment Table. " 
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within the resident portion of MONARCH. Those en- 
tries are defined in Appendix A. 


The loader gives an appropriate error indication when- 
ever a new entry is to be made in the symbol table that 


would | pouaas programs or data already stored in 


memory by the loader. This or 


to as symbol table overflow. oe Section 6 "Operating 


nditions is also referred 
NnaiTroer 


Procedures. 


THE LOADING PROCESS 


Relocation and Data Records 


A data record (record type 0) contains instructions and/ 
or data to be stored in memory by the loader. Each data 
record contains a load address that is either the relative 
or absolute memory location in which the first data word 
(an instruction or a constant) is to be stored. The word 
in the data record containing the load address also con- 
tains an indicator specifying whether or not the current 
load relocation bias is to be added to this load address 
to obtain an effective load address (i.e., whether or 
not the data record contains "relocatable" data words) 
for the program. 


The effective load address determines the location in 
which the first data word is stored, and successive data 
words in a data record are stored inconsecutive memory 
locations following the first data word. 


Before each data word in a program is stored its binary 
value may be modified as required (e.g., by load re- 
location modifier word; see Appendix F "SDS Standard 
Binary Language. ") 


External Label References and Definitions 


The loader is capable of handling (resolving) symbolic 
cross-references between separately assembled and/or 
compiled programs. External reference and definition 
items in type 1 binary records provide the loader with 
the information needed to "link" together two or more 
separately assembled or compiled programs. 


During the loading process, the loader maintains a sym- 
bol table of external label definitions and unsatisfied 
external references. There is no restriction on the order 
in which the definition of a label and the references to 
it appear in the input to the loader. The definition of 
a label may precede, or follow, some or all of the ref- 
erences to it. Note that it is permissible for any number 
of programs to contain references to a given label, pro- 
vided that one program being loaded contains an exter- 
nal definition item for that label. 


When the loader encounters an external definition item, 
it searches the symbol table for a previous definition of 
that label in the table; if there is one, the loader dis- 
cards the new definition. If the search reveals that the 
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label is already in the table as an unsatisfied reference, 
the loader uses the definition to satisfy all the references 
to that label and replaces the unsatisfied reference item 
in the table with the definition item. However, if that 
label does not occur in the symbol table (as a reference 
or as a definition), the loader inserts the external defin- 
ition item in the symbol table. 


When the loader encounters an external reference item, 
it searches the symbol table to see if it already contains 
an external reference item for that label; if so, the new 
external reference is associated with the existing table 
entry. If the search reveals that the label is already in- 
cluded in the table as an external definition the loader 
uses the definition to satisfy all the references to that 
label. However, if that label does not occur in the 
symbol table (as a reference or as a definition), the ex- 
ternal reference item is inserted in the symbol table. 


External Programmed Operator References and Definitions 


The loader is capable of satisfying references to internal 
and external Programmed Operator (POP) definitions. 
External POP definition items, external reference items, 
and internal POP definition items provide the loader 
with the information needed to: 


1. Satisfy external and internal POP references. 


i) 


Maintain externa! POP reference and definition 
ta 


items in the loader's symbol table. 


3. Construct a Programmed Operator transfer table in 


cells 0100g through 01778. 


An “internal” POP definition is one that is recognized 
only within the scope of the program in which it occurs. 
No entries are made in the loader's symbol table for in- 
ternal POP definitions or references. 


Many of the loader functions performed in the process- 
ing of external POP references and definitions are also 
performed (by the same loader subroutines) for external 
label references and definitions. In particular, the 
functions of insertion and replacement of symbol table 
entries and the handling of duplicate definitions are the 
same for both external label and external POP items. 


AUTOMATIC SELECTIVE LOADING 
FROM THE MONARCH LIBRARY 


Provision is made for automatic search of the MONARCH 
library when an end record with a transfer address is en- 
countered and unsatisfied label or POP references exist. 
This library normally consists of a collection of frequent- 
ly used closed subroutines and Programmed Operator sub- 
routines. The loader automatically loads any such 
subroutines when it encounters an external reference in 

a program (or group of programs) being loaded. This 
relieves the programmer of the burden of including such 


subroutines in the program decks (or tapes) he furnishes 
to the loader. For example, the programmer may wish 
to employ certain input/output subroutines available on 
the program library and refer to them symbolically in 
his main program. Note that the loader first attempts 
to satisfy all external references from the definitions 
supplied in the program decks (or tapes) furnished by 
the programmer, and only when this attempt is unsuc- 
cessful does it attempt to satisfy these references by 
loading programs from the program library. The follow- 
ing paragraphs describe the procedures employed to ac- 
cess programs in the program library. 


When the loader is loading a previously assembled pro- 
gram and there are external references that have not 
been satisfied when the end record with a transfer ad- 
dress is encountered, the loader causes the monitor to 
locate the MONARCH library on the system tape. The 
loader then enters a special mode in which it searches 
the external definition in each library program in suc- 
cession. When it encounters a library program which 
satisfies at least one such reference, it loads this pro- 
gram; then, if there are still some unsatisfied references, 
it continues to search the program library. To avoid 
"backtracking" when switching from "search" to "load" 
mode, the definitions from each library program being 
examined are temporarily added to the table of exter- 


nal definitions and references maintained by the loader. 
Note that the records containing external label defini- 
tions and external Programmed Operator definitions must 
precede all other information in a binary object program; 
hence, only these definitions have to be saved in mem- 
ory to enable the loader to switch from "search" to "load" 
mode without rereading records from the system tape. 


If a given library program does not contain a definition 
for any of the unsatisfied references, its definitions are 
removed from the table and the next library program is 
examined. If there are still unsatisfied external refer- 
ences when the end of the program library is encountered, 
the loader indicates that an error condition exists. 


The loader employs an entirely similar method in attempt- 
ing to obtain definitions for any unsatisfied Programmed 
Operator references. If these referencescannot be satis- 
fied from the Programmed Operator definitions on the 
system tape, the loader indicates that an error condition 
exists. The library search for Programmed Operators is 
concurrent with the search for external definitions of 
labels (i.e., the Programmed Operator definitions are 
part of the program library). Since MONARCH makes 
only one pass through the library, no routine on the li- 
brary can call a routine preceding it. 


Pes) 


4. PROGRAMMING WITH MONARCH 


, section describes MONARCH subroutines that can 
pe referenced from the user's program. Also discussed 
here is the MONARCH System Update Routine which is 
used to create new MONARCH system tapes and to up- 
date existing system tapes. 


OCTAL DUMP ROUTINE 


A Line Printer Octal Dump Routine with zero suppres- 
sion is incorporated in the MONARCH loader. This 
routine resides in the last 132g locations of memory and 
may be referenced internally or from the console. When 
the dump routine is to be referenced in a program, the 
following calling sequence must be assembled as part of 
the user's program: 


a BRM QDUMP 
a+] PZE Py 
a+2 PZE Po 
@+3 > return 


a representsany location. When the dump is completed, 
control is returned to the user's program at a+ 3. 


QDUMP is the externally defined label for the entry 
point of the routine and must be an externally de- 


fined symbol in the user's program. 


P_ specifies the beginning address of the sequential 
memory locations whose contents are to be printed. 


Po designates the ending address of the sequential mem- 
ory locations whose contents are to be printed. The 
address represented by P, must be equal to or great- 

Z 
er than that of Pi. 


P and PS may be numeric or symbolic (external). 
To reference the dump routine from the console, set the 
contents of the registers as follows: 


A = Beginning address (see P} above) 
B Ending address (see P> above) 
C= 


For 900 Series Computers: 


0 01 17650 for an 8K memory 
0 O01 23650 for a 1OK memory 
0 O1 27650 for a 12K memory 
0 01 33650 for a 14K memory 
0 01 37650 for a 16K memory 


For 9300 Computers: 


0 01 17646 for an 8K memory 

0 01 27646 for a 12K memory 

0 01 37646 for a 16K memory 
Position the RUN-IDLE-STEP switch to RUN. 
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To continue dumping when the computer halts, reset 
the A and B registers to the desired addresses and clear 
the halt. 


Note: On 900 Series Computers the octal dump routine 
operates only on machines with memory of 16K or 
less. 


SYMBOL TABLE TYPEOUT ROUTINE 


The Symbol Table Typeout Routine produces a list of all 
symbols and the location to which each is assigned. 
If Breakpoint 1 is reset, the symbol table is output on 
typewriter 1 on the W buffer; if Breakpoint 1 is set, the 
table is output on line printer 1 on the W buffer. 


To reference the symbol table typeout routine, set the 


contents of the 900/9300 C register to BRU TYPSY5: 


C = 001 17734 for an 8K memory 
0 01 23734 for a 10K memory 
0 01 27734 for a 12K memory 
0 01 33734 for a 14K memory 
= 0 01 37734 for a 16K memory 


Position the RUN-IDLE-STEP switch to RUN. The com- 
puter will halt after the typeout. The user may clear 
the halt, causing a transfer to QBOOT which reloads 
the MONARCH system, or he may transfer manually to 
any location (i.e., insert in the C register a BRU to the 
desired location). 


HT 


The output produced by this routine consists of two columns; 
the first contains the symbol, left justified with trailing 
blanks, and the second contains the memory location to 
which the symbol! was assigned. (See Appendix C for 
the method used in forming the addresses. ) 


It is suggested that, upon receiving the MONARCH 
system of programs, the user have a symbol table type- 
out produced. The listing produced will be useful when 
reference to a specific address within the MONARCH 
system of programs is required. A sample of such a 
listing appears in the discussion "Monarch Loader's 
Symbol Table" in Section 6. 


OCTAL CORRECTION ROUTINE 


Corrections may be made to a program at load time via 
octal correction cards. Such cards are placed just be- 
fore the end card in the binary deck. The format of 
correction cards is 


Py PoP3 --. Pas 


P_ is an address, consisting of up to five octal digits, 
that specifies the location of the first correction. 
P| may start in any column. If it does not start in 
column 1, a character string (P29) may precede P}1. 


P. is any character string (one or more characters) not 
containing an octal digit. If the first character of 
the string is an R, the preceding octal number is 
assumed to be relocatable. If the first character 
is any other character, the preceding octal number 
is assumed to be nonrelocatable. 


P, is the octal correction (one or moreoctal digits). If 
more than eight digits appear, only the last eight 
digits read (i.e., the eight low-order digits) are 
accepted, 


Succeeding octal numbers are stored in consecutive lo- 
cations relative to location P}. Continuation from one 
card to the next is not permitted. A period may serve 
as a terminator but is not required. If a period is used, 
any information following the period is treated as com- 
ments and is not processed. 


Examples: 


Assume that a program is to be loaded and that relative 
locations 212, 213, and 214 are to be changed to con- 
tain BRU 00235, BRU 00243, and HLT 00000, respective- 
ly. The necessary corrections could be written as 


2 2 2 


The same changes could also be written as 


PATCH ,212R = 1000235R, ,1000243R, ZRO = 0. 


Cn Oe ae ee a PoP 


If the program is loaded with a relocation bias of 1000, 
these locations will contain: 


Location Contents 

1212 01000235 
1213 01000243 
1214 00000000 


LOADER ROUTINE 


The MONARCH loader can be executed either via the 
appropriate MONARCH control messages or directly as 
a closed subroutine. The user's program can transfer to 
the loader by executing the instruction 


BRM QSYSLDR 
QSYSLDR is the externally defined label for the entry 


point to the loader and must be an externally defined 
symbol in the user's program. The loader assumes that 


the A register contains the load relocation bias to be 
used and that the B register contains the binary value of 
the loader option parameter (see LOAD control message 
in Section 2). 


The loader commences execution by reading a record 
from the previously designated binary input medium and 
checking the first word (control word) of the record to 
see whether or not it is a valid binary record. Next, 
the record type code (see Appendix F) of the control 
word is used to indicate the appropriate subroutine with- 
in the loader for processing that type of record. 


When the loader has processed a record, it continues by 
reading in the next record unless the record just process- 
ed is an end record (record type code of 3). When an 
end record without a transfer address has been processed, 
the loader, depending upon the value of the loader op- 
tion parameter, does one of three things: 


1. Halts with: 
C = 0 20 22222 
A 


load relocation bias to be used for loading the 
next program (unless changed manually by the 
console operator) 


B = indeterminate 


2. Returns control to the program that called the load- 
er (by executing a BRR QSYSLDR), with: 


B = initial load relocation bias plus program length 
A 


3. Sets the load relocation bias equal to its previous 
value plus the length of the current program (as _ 
specified in the end record) and continues loading 
records. 


I 


loader option parameter 


When an end record with a transfer address is encount- 
ered, a library search is made to satisfy references. Then 
any indicated relocation is performed on the single data 
word in the end record, and the loader, depending on 
the value of the loader option parameter, does one of 
two things: 


1. Halts with: 


C = transfer word as modified by any relocation 
indicative present in the end record 


A 


loader option parameter 
B = load relocation bias 


2. Executes the transfer word after performing any in- 
dicated relocation of the address field. Normally, 
the transfer word is a BRANCH UNCONDITIONAL 
instruction (BRU), whose address is determined by 
the value of the expression in the operand field of 
a SYMBOL or META-SYMBOL END line. 


The loader does not "initialize" unused memory loca- 
tions with "background" values (e.g., halt instruction). 
The only memory locations modified by the loader are 


1. Those within the locations occupied by the loader 
and its input subroutines. 


2. Those locations pre-empted by the loader for its 
symbol table. 


3. Locations in which the loader is explicitly directed 
to store instructions or constants (i.e., data words 
supplied to the loader in data records), 


SYSTEM UPDATE ROUTINE 


This routine is used to create new MONARCH system 

tapes and to update existing system tapes. The func- 
tions of insertion and deletion of both system programs 
and data files (including the MONARCH monitor and 

the MONARCH loader) are provided. 


Since each routine on the system tape (except the boot- 
strap loader and the MONARCH loader) is preceded by 
an identifier (a MONARCH ID record), insertions and 
deletions are indicated to the update routine in terms 
of those identifiers. The MONARCH loader has the 
identifier LOAD associated with it even though no 
MONARCH ID record actually precedes that routine on 
the system tape. The bootstrap loader is automatically re- 
corded on anew system tape as the first record on the tape. 


It may be necessary to include, as standard system rou- 
tines, programs whose memory space requirements pre- 
clude the use of the MONARCH loader to load them at 
execution time. Such programs should be preceded on 
the system tape by a special purpose loader that is capa- 
ble of loading the system routine in question from the 
system tape. It is this special purpose loader which is 
loaded, and executed, under control of the MONARCH 
loader when a MONARCH control message calls for ex- 
ecution of the system routine in question. 


All programs on a MONARCH system tape, with the ex- 
ception of the bootstrap loader, must be in either SDS 
standard binary language or FORTRAN binary language. 
Data files to be recorded on a MONARCH system tape 
must be presented to the update routine in either of these 
formats or else in SDS encoded symbolic format. The 
only other form of information permissible on a MON- 
ARCH system tape is MONARCH ID records. Such rou- 
tines and data files must be presented to the update 
routine on punched cards, paper tape, or magnetic tape. 


It is also noted that a standard system routine (e.g., the 
META-SYMBOL assembler) may itself consist of several 
independently assembled subprograms and only the first 
of these is preceded on the system tape by a level 1 
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MONARCH ID record. Hence, the MONARCH loader 
automatically loads any subprograms following the first 
subprogram until it encounters either the next level 1 
MONARCH ID record or a binary end record (type 3) 
with a transfer address. The MONARCH update routine 
acknowledges this type of program structure when per- 
forming insertion and deletion functions in the course of 
writing a new system tape. Any or all of the subpro- 
grams of a standard system routine may be preceded on 
the system tape by a level 2 MONARCH ID record to 
permit insertion or deletion of individual subprograms 
by the MONARCH update routine. These level 2 MON- 
ARCH ID records are ignored by the MONARCH loader 
when loading a standard system routine for execution. 


The update routine produces a typewriter or line printer 
listing of the MONARCH ID records (level 1 and level 
2) associated with all routines and all data files written 
on anew system tape. These ID records appear on the 
listing in the order in which they exist on the new sys- 
tem tape. This listing should be preserved for use as the 
basis for constructing update control messages for the 
next system update run. (See examples later in this sec- 
tion, ) 


Routines to be inserted by the MONARCH update rou- 
tine must be preceded by a level 1 and/or level 2 
MONARCH ID record and must be presented in the order 
in which they appear on the new system tape. COPY 


messages (i.e., controi messages to the update routine) 


must be presented in the order in which they are to be 
executed. No reordering of update input is performed. 


THE UPDATE CONTROL MESSAGE 


When the update routine is loaded for execution by the 
MONARCH loader, the MONARCH unit assignment 
table is assumed to contain the following information: 


1. QMSG (control message input unit) contains the 
unit and channel designation for the peripheral de- 
vice that is to furnish MONARCH control messages 
and update control messages. The unit must be a 
card reader or a typewriter. 


2. QSYSU (the update input unit UI) contains the unit 


and channel designation for the peripheral device 
that is to furnish any programs or data files to be 
inserted in the new system. The unit must be a card 
reader, a paper tape reader, or a magnetic tape 
unit. 


3. QSYST (system scratch tape X1) contains the unit 


(magnetic tape only) and channel designation for 
the peripheral device upon which the new system 
tape will be written. 


4. QSYS (sytem tape S) is assumed to specify magne- 
tic tape unit 0 on channel W and the old system 
tape is assumed to be mounted on that unit. How- 
ever, if both QSYS and QSYST contain the same 
unit and channel designation, the update routine 
assumes that no old system tape is present. 


5. QSYMO (list output unit LO) is assumed to specify 
whether MONARCH ID records will be listed on 
the line printer (LO=LP) oron the typewriter (LO=TY). 


It should be noted that the update control message input 
unit (QMSG) and update input unit (UI) assignments may 
differ. For example, QMSG may be assigned to the 
card reader (CR) and update input (UI) may be assigned 
to a paper tape, magnetic tape, or card reader. 


The following sequence of MONARCH control messages 
illustrates the means of setting up the unit assignment 
table and calling in the update routine for execution. 


AC CRIW. 

AASSIGN S=MTOW, XI=MTIW, UIFCRIW. 
AASSIGN — _LO=LP. 

AUPDATE 256. 


The MONARCH update routine has two modes of oper- 
ation: the normal mode and the blocking mode. In the 
normal mode all records are written as 40-word records. 
In the blocking mode all records (MONARCH ID records 
excluded) are written as blocked records. The maximum 
length of a blocked record is determined by the block- 
ing number which is a parameter of the update control 
message (41}9 < blocking number < 256)9). If the block- 
ing number is less than 41, 41 is automatically used. If 
the blocking number is greater than 256, 256 is automa- 
tically used. 


A blocked record consists of a 1-word block sentinel 
(defined below) followed by one or more "logical" re- 
cords. A "logical" record is one of the following: 


1. A MONARCH ID record (40 words). 


2. A binary record (average length fewer than 28 
words, maximum length 31 words). 


3. An encoded symbolic record (40 words maximum). 
An unblocked record consists of a single logical record; 
however, all unblocked records are written as 40-word 


records even if the logical record contains fewer than 
40 words. 


The block sentinel word has the following format: 


Bits Contents 
0- 8 0 
9-1] 3 
12 - 23 Number of words in physical record 


(including the block sentinel word) 


The blocking number serves a twofold purpose: it spec- 
ifies the maximum number of words per record and indi- 
cates whether the update routine is to operate in the 
blocking mode on the selected segments. If no blocking 
factor is specified, the update routine operates on all 
segments in the normal mode. 


Which segments are to be blocked when the update rou- 
tine is operating in the blocking mode is determined by 
the level 1 or level 2 MONARCH ID record preceding 
that segment. If a level 1 or level 2 MONARCH ID 
record contains a B in character position 22 and blanks 

in character positions 21, 23, and 24, everything with- 
in the scope of that level 1 or level 2 ID record is block- 
ed. Since the MONARCH loader is not preceded by a 
MONARCH ID record, it is automatically blocked when- 
ever a blocking mode is specified. 


CONTROLLING AN UPDATE RUN—- 
THE UPDATE FILE 


Normally, two logical "files" are presented to the up- 
date routine to enable it to create a new system tape. 
One of these files is the old system tape, and it is an 
optional input. The other file is the update file; it is 
never optional, although its form and content may vary 
considerably. 


In the general case, the update file consists of an or- 
dered sequence of COPY messages, MONARCH ID re- 
cords, binary records, and encoded symbolic records. 

In a particular instance, an update file may consist en- 
tirely of COPY messages, in which case only the func- 
tions of selective duplicating and selective deleting are 
performed. Alternatively, a given update file may con- 
sist entirely of MONARCH ID records, binary records, 
and encoded records, in which case only the functions 
of selective insertion and, by the absence of COPY mes- 
sages, blanket deletion of all information on the old 
system tape are performed. In the latter case, the ab- 
sence of COPY messages removes the requirement for 
providing an old system tape for the update run. 


Physically, the update file can exist entirely on magne- 
tic tape, on punched cards, or (although highly unlikely 
entirely on paper tape. Alternatively, all COPY mes- 
sages and MONARCH ID records in the update file can 
be presented as typewriter messages while any programs 
to be inserted are presented on punched cards, paper 
tape, or magnetic tape. (Samples of update file listings 
are included at the end of this section. ) 


Insertion 


Insertion is controlled by presenting the update routine 
with a MONARCH ID record via the control message 
medium (QMSG) which may also be the update medium 
(QSYSU), and one or more programs (or data files) via 
the update medium (QSYSU). The MONARCH ID record 


No 
Ww 


is the first record written on the new system tape. The 
update routine then copies records from the update me- 
dium onto the new system tape until: 


1. An end-of-file condition (not AEOF) is detected. 
The update routine will then request a control 
message. 


2. A possible COPY message is encountered; i.e., a 
record other than a binary, encoded, or MONARCH 
ID record. (The update routine proceeds to analyze 
it as if it were a control message. ) 


3. If the update medium is paper tape and a binary or 
encoded end record (type 3) is encountered, a halt 
is executed. (Set (A) = 0 to continue insertion, or 
set (A) 4 0 to stop insertion and cause the update 
routine to request a control message next; then set 
the RUN-IDLE-STEP switch to RUN. ) 


4. A level 1 MONARCH ID record with SYSEND, , 
in characters 9 through 16 was written on the new 
system tape. (Both old and new system tapes are 
rewound, and the monitor is loaded from the system 
tape on unit 0 of the W buffer. ) 


Note: When an insertion is under control of a level 2 
MONARCH ID record and the insertion is to be- 
come, or replace, the first subdivision of amajor 
division of the system tape, the level | 
MONARCH ID record for the major division 
must precede the level 2 MONARCH ID record 
in the update file. (See examples at the end of 
this section. ) 


Programs to be inserted must be in SDS standard binary 
language. Data files must be in this format or else in 
SDS 9300/900 Series encoded symbolic format. 


All binary and encoded records inserted in a new system 
tape will have their checksums validated by the update 
routine. 


Deletion 


Deletion of programs or data files from an old system 
tape is accomplished by simply excluding those programs 
or data files from the scope of a COPY message. In 
other words, failure to COPY a program results in its 
being deleted from the new system tape. 


Replacement 

Replacement of programs or data files is accomplished 

by deleting (not COPYing) the existing program or file 
and by inserting a new version of that program or file. 


Retention (COPY function) 


Retention of programs or data files is accomplished by 
including those programs or data files in the scope of a 
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COPY message. Retention must be made explicit; the 
only program implicitly "retained" from an old system 
tape to a new system tape is the bootstrap loader, but 
this program is not "copied" from the old tape by dupli- 
cating the first record on the old tape. It is in core at 
the time the update routine is executed; therefore, the 
update routine writes the bootstrap loader from core onto 
tape as its first operation (i.e., immediately after con- 
trol is transferred to it and before any COPY messages 
are read). All binary and encoded records written on 
the new system tape will have their checksums validated 
by the update routine. 


COPY MESSAGES 


The purpose of a COPY message is to obtain programs or 
data files from the old system tape and record them on 
the new system tape. The COPY message is used in lieu 
of placing the indicated programs in the update file. 
COPY messages refer to records (e.g., binary programs) 
by using the program names that appear in character po- 
sitions 9 through 16 of the MONARCH ID records on the 
old system tape. 


Major divisions of a MONARCH system are preceded, 
on the system tape, by a level 1 MONARCH ID record: 


A e e ° 

LARA AREIBRAR YS 

Minor divisions of ad MONARCH system are preceded, 
on the system tape, by a level 2 MONARCH ID record 


22 AAAAACOSINE, a+ - 
Minor divisions of a MONARCH system are arbitrary 
subdivisions of a program or a data file recognized by 
the update routine (see description of the MONARCH 
Loader in Section 3 for mention of another use of level 2 
MONARCH ID records in connection with automatic li- 
brary searching). 


Each MONARCH ID record must have a unique label. 
Labels may not contain separators (see Section 2). In 
other words, each label must be explicit; a label such as 


AVA AAAAASIN, COS, ++: 


is illegal because of the comma. 


If an argument of a COPY message consists of one 
program name, the name is assumed to occur in charac- 
ters 9 through 16 of a level 1 MONARCH ID record on 
the old system tape. If an argument of a COPY message 
consists of two program names (the second may be en- 
closed in parentheses), the first (leftmost) is assumed to 
occur in characters 9 through 16 of a level | MONARCH 
ID record on the old system tape, while the second pro- 
gram name is assumed to occur in characters 9 through 
16 of a level 2 MONARCH ID record which occurs 


subsequent to the level 1 record. In other words, the 
second program name is assumed to refer to asubdivision 
of the major divisionof theold system tape that was iden- 
tified by the first program name. For example, 


ACO PY A aLIBRARY (COSINE). 


LIBRARY is a level 1 ID record, and COSINE is a level 
2 ID record within the scope of LIBRARY. 


Execution of a COPY message by the MONARCH up- 
date routine involves copying the MONARCH ID re- 
cord(s) and any binary or encoded records that are in 
the scope of the MONARCH ID records named in the 
COPY message. 


The term "in the scope of" is defined as follows: 


If "A" and "B" are distinct program names in level 
1 ID records, and "X" and "Y" are distinct pro- 
gram names in level 2 ID records, then: 


1. Av-binary or encoded record (r) is "in the 
scope of" A provided that no other level 1 ID 
record occurs between Aand ron the system tape. 


2. A binary or encoded record (r) is "in the scope 
of" X provided that no other level 2 ID record 
occurs between X and r on the system tape. 


3. X is "in the scope of" A provided that no other 
level 1 ID record occurs between A and X on 
the system tape. 


4, A binary or encoded record (r) is "in the scope 
of" both X and A if rules 1, 2, and 3 apply. 


5. If a binary or encoded record (r) is "in the 
scope of" X, it is not "in the scope of” Y. 


6. If abinary or encoded record (r) is "in the’ 
scope of" A, it is not "in the scope of" B. 
The Syntax of COPY Messages 


A valid COPY message is an instance of one of the 
following: 


A... COPY, ¢. 
A, jCOPY ,a, (b). 

A. »COPY ,a THRU ,b. 
Bin, ,COPY a, (e), THRU .b. 
A, hCOPY a, THRU ,b (A). 


Ann nACOPY ,9,(c),, THRU ,6 , (d)- 


where a, b, c, andd represent program names (MONARCH 
ID labels). The first character of a program name must 
be alphabetic and each remaining character must be 
either alphabetic or numeric. Each name may consist 
of up to eight characters. The message must be termi- 
nated by a period. 


Parentheses may be omitted, their only purpose being to 
enhance readability. 


The caret (A) is used to indicate the minimum number of 
spaces that must separate words in a COPY message. 


COPY messages without the word THRU are said to have 
one argument. COPY messages with the word THRU are 
said to contain two arguments. Each argument consists 
of either one or two program names. 


COPY Messages with One Argument 


A COPY message with one argument consisting of one 
program name causes the update routine to read all re- 
cords in the scope of the level 1 ID record with the same 
name from the old system tape and write them on the new 
system tape. For example, when 


A, jCOPY LIBRARY. 


is encountered, the update routine bypasses any records 
on the old system tape preceding the level 1 MONARCH 
ID record with LIBRARY, in characters 9 through 16. 
This is the first record to be written on the new system 
tape in response to this COPY message. The update rou- 
tine then copies all records following that ID record un- 
til the next level | MONARCH ID record is encountered 
on the old system tape. It is this "next" level 1 record 
that terminates the copying of records from the old sys- 
tem tape; it is not copied onto the new system tape as a 
result of this COPY message, but it is the first "old sys- 
tem tape" record to be examined when the next update 
control message is processed. 


A COPY message with one argument consisting of two 
program names causes the update routine to read all re- 
cords in the scope of the level 2 MONARCH ID record 
corresponding to the second program name and write them 
on the new system tape. For example, when 


Arr ACOPY , LIBRARY , (COSINE). 


is encountered, the update routine bypasses any records 
on theold system tape preceding the level 1 MONARCH 
ID record with LIBRARY, in characters 9 through 16; 
that is, unless the old system tape is already positioned 
at, or beyond (but still within the scope of), that level 
1 IDrecord. In either case, the update routine searches, 
within the scope of LIBRARY, for a level 2 MONARCH 
ID record with COSINE, , in characters 9 through 16. 
If the level | MONARCH ID record for LIBRARY has not 
already been written on the new system tape, it is the 
first record written on the new system tape in response 
to this COPY message. In either case the update rou- 
tine writes, on the new system tape, the level 2 MON- 
ARCH ID record with the name COSINE. The update 
routine then copies all records following that ID record 
until the next MONARCH ID record (either level 1 or 
level 2) is encountered on the old system tape. It is 
this "next" MONARCH ID record that terminates the 
copying of records from the old system tape. It is not 
copied onto the new system tape as a result of this COPY 
message, but it is the first "old system tape" record 
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to be examined when the next update control message 
is processed. 


COPY Messages with Two Arguments 


A COPY message with two arguments is equivalent to a 
series of "one argument" COPY messages. The update 
routine performs the necessary copying indicated by the 
first argument exactly as in the case of a 1-argument 
COPY message; but, in addition, it copies all records 
following those included in the scope of the first argu- 
ment until the MONARCH ID record whose name matches 
the second (or only) program name! of the second argu- 
ment is encounterede At this point, the update routine 
performs the necessary copying indicated by the second 
argument exactly as in the case of a 1-argument COPY 
message. 


Special tests are made to detect cases in which the first 
and second arguments are identical. When this occurs, 
the COPY message is reduced to the equivalent 1- 
argument COPY message. 


The following sets of COPY messages are equivalent if 
"A", "B") and "C" occur (in that order) as program 
names in consecutive level 1 MONARCH ID records on 
a system tape: 


Set 1: AajaaCOPY A THRU A. 
AAAACOPY B THRU B. 
An nnCOPY C THRU C. 

Set 2; A,,~,jCOPY A. 
AAAACOPY B. 
Ani , COPY Ce 


Set 3: AajavjajCOPY A THRU A. 
AAAACOPY B THRU C. 


Set 4. Aa,avavCOPY A THRU B. 
A, annCOPY C THRU C. 


Set 5: A,,aCOPY A THRU C. 


Thus, the use of THRU, in a COPY message with two 
arguments, provides an alternative to using a series of 
l-argument COPY messages. 


Termination of an Update Run 
COPY messages of the form: 
AnrnnCOPY, SYSEND, ,- 


or 
Ann aCOPY na a(b) aTHRUASYSEND ja. 


cause the indicated COPY function to be performed, the 
update process to be terminated, the new system tape to 
be rewound, and control to be returned to the MONARCH 
monitor. In this case, the MONARCH monitor in ques- 
tion is "bootstrapped" from tape 0 on the W buffer. 


Matching of the second program name is inhibited until 
a level 1 MONARCH ID record whose name matches the 


first program name is encountered. 
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CONTENTS OF A TYPICAL MONARCH 


SYSTEM TAPE 


| record containing MONARCH bootstrap and LOADER 


RK ACNKS 


first record of MONARCH loader 


Last record of MONARCH loader 


Al MONITOR 
first record of MONARCH monitor 


Last record of MONARCH monitor 


A) PRINT 
first record of PRINT subroutine 


END record of PRINT subroutine 


Al MTAPE 
first record of MTAPE subroutine 


END record of MTAPE subroutine 


Al CDRP 
first record of CDRP subroutine 


END record of CDRP subroutine 


Al PTYIO 
first record of PTYIO subroutine . 


END record of PTYIO subroutine 
Al LIBRARY 


A2 SINE 
first record of SINE subroutine 


END record of SINE subroutine 


A2 COSINE 


Al SYSEND 


EXAMPLES 


Facsimile of a typical listing of MONARCH ID records 
resulting from a MONARCH update run: 


Al LOAD. 

Al MONITOR. 
A2 CONTROL. 
A2 TABLES. 
A2 QMSGRD. 
A2 LDIOSR. 


A2 CARD. 
A2 MTYIO. 
A2 MAGTP. 
A2 TFMONRCH. 
Al PRINT. 
Al MTAPE. 
Al CDRP. 
Al PTYIO. 
Al CDR. 
Al LIBRARY. 
A2 CDRP. 
A2 CDR. 
A2 PRINT. 
Al META920. 
A2 ENCODER. 
A2 MONI. 


A2  MSCONTRL. 
A2  PREASSEM. 
A2  ASSEMBLR. 
Al UPDATE. . 
A2 BOOTSTRAP. 
A2 — UPDATERT. 
Al SYSEND. 


Examples of Program Sequences for Update Runs 


ls 


To duplicate an existing MONARCH system tape: 


AC-TYIW. 7 a VY iw 
AASSIGN S=MTOW, XI=MTIW, UIECR4W, LO=LP. 
AUPDATE,256, 


Arn pjCOPY LOAD THRU SYSEND, ,. 


To insert a system routine ("RN") between existing 
system routines "RI" and "R2": 


AC CRIW. wn ge 
AASSIGN S=MTOW, XI=MT1W, UIFEREW, LO=LP. 
AUPDATE. 

Aprr~ACOPY LOAD THRU RI. 


AL AAAAAARNAAAAAAS 


“T 


"first binary record of RN" 


"last binary record of RN (end record)" 


A nrnCOPY R2 THRU SYSEND, ,. 


To delete a system routine ("R7") that appears on 
the old system tape between system routines "R6" 
and "R8"; 


AC CRIW. 

AASSIGN S=MTOW, XI=MTIW, UI=FCRIW, LO=LP. 
AUPDATE. 

AAAACOPY LOAD THRU Ré. 

AAAACOPY R8 THRU SYSENDAa. 


To replace a system routine ("R7"), appearing on 
the old system tape between "R6" and "R8", with 
a new version of "R7": 


AC CRIW. 

AASSIGN S=MTOW, X1=MTIW, UIFCRIW, LO=LP. 
AUPDATE. 

AnnvnCOPY LOAD THRU R6. 


ALAA AAAARZ AAAAAAS 


"first binary record on new version of R7" 


"last binary record of new version of R7" 
A, ~rjCOPY R8 THRU SYSEND, ,. 


To insert a new subroutine ("NEW") as the first 
subdivision under "LIBRARY", where "LIBRARY" is 
the name ina level 1 MONARCH ID record on the 
old system tape, "CDR" is the name in the level 1 
MONARCH ID record immediately preceding 
"LIBRARY", and "CDRP" is the name in the first 
level 2 MONARCH ID record under "LIBRARY" on 
the old system tape. 


AC CRIW. 

AASSIGN S=MTOW, X1=MTIW, UIEFCRIW, LO=LP. 
AUPDATE. 

AAAACOPY LOAD THRU CDR. 
ATAAAAAALIBRARYA. 

D2, AKA AANEWAAA AA: 


"first binary record of NEW" 


"last binary record of NEW" 


AAAACOPY LIBRARY (CDRP) THRU SYSENDaa. 


To re-order the system tape. Re-ordering of the 
system tape is accomplished by initializing a rewinc 
following a series of COPY messages and/or inserts, 
then reading and executing a new series of COPY 
messages. This allows for repositioning logical files 
on the system tape without having to include the 
binary decks. 
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The control card for the rewind is recognized by 
the update routine. The format of the card is 

AREWIND. No blanks are allowed. (In the up- 
date routine AREWIND implicitly rewinds MTO. ) 


Example: 


Old system tape order is the following se- 
quence of level | ID records: 


ABC D SYSEND 
New order of tape requires: 
AC DB SYSEND 


The series of COPY messages should be: 


A, COPY A. 
A, aCOPY C THRU D. 
AREWIND. 
A, COPY B. 
An, COPY SYSEND, ,. 
ERROR HALTS DURING UPDATE RUNS 


Certain error conditions occurring during an update run 
cause an error message to be typed and the computer to 
halt. These error conditions are self explanatory and 
include the corrective action needed. The term OST 
refers to the old system tape (S), the term NST refers to 
the new system tape (X1), and the term UPD refers to 
the update input medium (UI), in the texts of the error 
messages. 


J. PREPARING PROGRAM DECKS 


META-SYMBOL ASSEMBLY AND EXECUTION Assemble META-SYMBOL symbolic and encoded input 
from card reader. (Note that A EOF indicates termina- 
Assemble a META-SYMBOL symbolic program to produce tion of SI) 


an object program for a 910/925, 


Encoded deck 


Symbolic deck 
AMETA9YI10 SI, BO, LO. 
AASSIGN S=MTOW, X1=MT2W. 
AASSIGN SIFCRIW, BO=PP1W. 


Symbolic deck 
AMETA920 SI, EI, BO, LO. | 


AASSIGN S=MTOW, XI=MTIW. 
AASSIGN X2=MT2W, SIEFCRIW. 
AASSIGN EI=CRIW, BO=PP1W. 
AASSIGN LO=LP. 


AASSIGN LO=LPIW. 


Assemble a META-SYMBOL encoded deck to produce an Assemble META-SYMBOL encoded deck with symbolic 
object program for 920/930. (Note that encoded deck corrections on a 900 Series Computer to produce an ob- 
requires no EOF indication.) ject program to run on 9300, 


Encoded deck 


Symbolic correction cards 


AMETA9300 SI, EI, BO, LO« 


Encoded deck 
AMETAQ9Z20 EI, BO, LO. 
AASSIGN S=MTOW, X1=MT2W. 
AASSIGN EI=CRIW, BO=PP1W. 


AASSIGN S=MTOW, XI=MTIW. 
AASSIGN X2=MT2W, SI=CRIW. 
AASSIGN EI=CRIW, BO=PPIW. 


AASSIGN LO=LP. 


ENCOVED F/G med X f= WTI, K 2 = 
dow + forge e ) 2 


sO 


Assemble a META-SYMBOL encoded deck with symbolic 
corrections, requesting a concordance listing and speci- 
fying symbols to be included and/or excluded. 


| / AENDJOB. | 


EXCLUDE/INCLUDE cards 


Encoded program 


Symbolic correction cards 
AMETAQ20 SI, EI, LO, EXCP. 
AASSIGN S=MTOW, X1=MT1W. 
AASSIGN X2=MT2W, SIFCRIW. 
AASSIGN EIFCRIW, BO=PPIW. 
AASSIGN LO=LP. 


Assemble and execute a META-SYMBOL source program. 


data (if any 
ALOAD 0, GO. 


AASSIGN BI=FMT2W. 
AEOF. 


Symbolic deck 
AMETA920 SI, BO, LO. 


AASSIGN S=MTOW, X1=MTIW. 
AASSIGN BO=MT2W. 
AASSIGN SI=CRIW, LO=LPIW. 
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FORTRAN COMPILATION AND EXECUTION 
(200 Series Only) 


Compile a FORTRAN source program. 


FORTRAN source program 
AFORTRAN LO, BO. 


AASSIGN SI=CRIW, BO=MTIW. 
AASSIGN S=MTOW, LO=LP. 


Compile and execute a FORTRAN source program. 


AASSIGN S=MTOW, SI=FCRIW. 
AASSIGN BO=MT1IW, LO=LP. 


Compile and execute a FORTRAN program input from 
paper tape. If the source tape does not end with a AEOF, 
control must be transferred to MONARCH manually. 


data (if any) 
AFORTLOAD BI. 


AASSIGN BI=MTIW. 
AFORTRAN LO, BO. 


AASSIGN S=MTOW, SI=PRIW. 
AASSIGN BO=MT1W, LO=LP. 


Compile and execute a FORTRAN program which in- 
cludes a FORTRAN subroutine and function. 


AFORTLOAD BI. 


AASSIGN BI=MTIW. 


FORTRAN function 


"FORTRAN subroutine 


FORTRAN main program 
AFORTRAN LO, BO. 


AASSIGN S=MTOW, BO=MTIW. 
AASSIGN LO=LP, SI=CRIW. 


Compile and execute a FORTRAN program that uses a 


subroutine, written in META-SYMBOL language, which 


must be assembled. 


data (if any) 
AFORTLOAD BI. 
AASSIGN BI=MTIW. 


FORTRAN subroutine 
written in META-SYMBOL 


AMETA920 SI, BO, LO. 


FORTRAN source program 
AFORTRAN LO, BO. 
AREWIND MTIW. 
AASSIGN S=MTOW, BO=MT1W. 
AASSIGN LO=LP, SI=FCRIW. 


(oe) 


— 


Compile and execute a FORTRAN program which uses a 
previously assembled (or compiled) FORTRAN subroutine 
on cards. 


“data (if any) 


‘Previously.assombled 
FORTRAN subroutine 
AFORTLOAD BI, X1. 


AASSIGN X1=CRIW, BI=MT IW. 


"FORTRAN source program | 
AFORTRAN LO, BO. 


AASSIGN S=MTOW, BO=MT 1W. 
AASSIGN LO=LP, SIECRIW. 


Execute a previously compiled FORTRAN program. 


data (if any 


Previously compiled FORTRAN 
main program 


AASSIGN S=MTOW, X1=CRIW. 
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Execute a previously compiled FORTRAN program that 
uses a subroutine, written in META-SYMBOL language, 
which must be assembled. 


PO 


‘data (if any) 


Previously compiled FORTRA 
main program 
AFORTLOAD X11, BI. 
AASSIGN X1=CRIW. 
AASSIGN BI=MTIW. 


AREWIND MTIW. 
/ AWEOF MTIW. 


FORTRAN subroutine written in 
META-SYMBOL 


AMETA920 SI, BO, LO. 


AASSIGN S=MTOW, SIEFCRIW. 
AASSIGN BO=MTIW, LO=LP. 


ALGOL COMPILATION AND EXECUTION 


Compile an ALGOL source program input from cards. 


Symbolic deck 
AALGOL BO, LS, LO. 
AASSIGN S=MTOW, X1=MTIW. 


AASSIGN LO=LP, BO=PP1W. 


Compile an ALGOL source program input from paper 
tape. 


AALGOL BO, LS. 
AASSIGN S=MTOW, X1=MTIW. 
AASSIGN SI=PRIW, LO=LP. 
AASSIGN BO=CPIW. 


Compile and execute an ALGOL source program input 


from cards. 


AENDJOB. 


data (if any) 
AALGOLOAD. 
AREWIND MT2W. 
AASSIGN BI 


Symbolic deck 
AALGOL BO, LS. 


AASSIGN S=MTOW, XI=MTIW. 
AASSIGN SI=CRIW, LO=LP. 
AASSIGN BO=MT2W. 


Execute a previously compiled ALGOL program. 
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"next operation" 


AREWIND MT2W. 


AWEOF MT2W. 


SSING = 
Encoded 


ALOAD0, TGO, ‘RECON’, 


AFORTLOAD X1, BI, 
AASSIGN BI=FMT4W, X1=CR. 


AREWIND MT4W. 
AWEOF MT4W. 
AEOF. 


Previously compiled 


J FORTRAN main program 


f/f. er fateva } 


AMETA920 SI, BO, LO. 


AREWIND MT4W. 
AASSIGN BO=MT4W. 


Encoded program deck 
AMETA9300 EI, EO, BO, LO. 


eq 
FFORTRAN subroutine written 
in META-SYMBOL 


Symbolic program deck 
AMETA910 SI, BO, LO. 


Encoded program deck 


Symbolic correction cards 
AMETAQ9Z20 SI, EI, EO, BO, LO. 
AASSIGN BO=CRIW, EO=CP. 
AASSIGN S=MTOW, LO=LP. 
AASSIGN EI=FCRIW, X2=MT2W, 
AASSIGN SI=CRIW, X1=MT1IW. 


"RECON is ¢ routine on the system tape. As directed by 
parameters input from the typewriter, RECON reads en- 
coded cards and reconstructs them symbolically on mag- 
netic tape. A description of this routine may be obtained 
from the SDS Program Library by ordering catalog number 
000022. 
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6. OPERATING PROCEDURES 


LOADING THE MONARCH SYSTEM 


Mount the MONARCH system tape on magnetic 
tape unit 0 on the W buffer; the unit must be ready 
for operation and the tape positioned at load point. 


To load the system initially, proceed as follows: 
a. For SDS 910/920 Computers: 


(1) Set registers X, C, and P and memory 
cell 1 as follows: 


00001 = 0 32 00002 ~=WIM 2 


X =77777771_— 7 
P = =0 
C  =002 03610 EOM 03610 


(2) Set the RUN-IDLE-STEP switch to RUN. 
(Do not STEP first.) 


b. For SDS 925/930 Computers: 


Execute the magnetic tape FILL procedure. 


c. For SDS 9300 Computers: 
(1) Press RESET. 
(2) Execute a magnetic tape FILL. 


To reload the system once it has been loaded: 


a. For 900 Series Computers: 
(1) Set C=001 00001 BRU 00001 
(2) Set RUN-IDLE~STEP switch to RUN. 


If this procedure fails: 
(1) Set C=001 x7736 BRU QBOOT 


X = 1 for an 8K computer 
= 2 for a 12K computer 
= 3 for a 16K computer 


(2) Set RUN-IDLE-STEP switch to RUN. 


If this also fails, execute the loading proce- 
dure described in paragraphs 1 and 2 above. 


b. For 9300 Computers; 


(1) Press RESET. 
(2) Press STEP. 
(2) 
\) 


If this procedure fails, execute the loading 
procedure described in paragraphs | and 2 
above. 


FURNISHING CONTROL MESSAGES 


When the MONARCH system is initially loaded, the 
monitor attempts to obtain a control message from the 
console typewriter, i.e., the device indicated by the 
contents of QMSG in the unit assignment table. The 
control message medium may be changed from the device 
currently in use to another input device with a C con- 
trol message (described in Section 2). For example, to 
change the control message medium to card reader 1 on 
the W buffer, use the control message 


AC CRIW. 


After processing a C control message, MONARCH imme- 
diately attempts to read a control message from the 
newly assigned device. Control messages may be sup- 
plied on punched cards, paper tape, magnetic tape, or 
manually via an on-line typewriter. 


At any given time while the MONARCH monitor has con- 
trol of the computer, it expects to be able to obtain the 
next control message from the control message medium 
currently assigned. This imposes the following require- 
ments on the console operator. If the medium is a: 


1. Console typewriter, the console operator should be 
prepared to furnish a control message, via the type- 
writer, whenever its input light is lit. 


2. Paper tape reader, the console operator should make 
certain that a paper tape containing a control mes- 
sage is inserted in the paper tape reader before the 
control request is made and that the paper tape 
reader is in operation. 


3. Card reader, the console operator should make cer- 
tain that a card containing a control message is in 
the card reader's input hopper and that the device 
is ready for operation. MONARCH reads cards in 
binary mode and converts the card image to SDS 
internal code before analyzing the message. 


4. Magnetic tape, the console operator should make cer- 
tain that areel containing a physical record witha 
control message in it is mounted on the tape unit and 
that the unit is in ready status. MONARCH reads the 
tape in binary (odd parity) mode and assumes the maxi- 
mum record length is 40 words. 


If programs or data precede the next control message on 
the current control message medium (2, 3, or 4 above), 
MONARCH reads successive records from the unit until 
a control message record is encountered or an end-of- 
file condition occurs (cards and magnetic tape only). If 
an end-of-file is encountered before a control message 
is read, MONARCH types an appropriat > message and 
requests the next control message from typewriter 1 on 


the W buffer. 


Loy) 
nn 


Contents of 
Register C 


00 1xxxxx 
(xxxxx = 
transfer ad- 
dress from 
end card) 


001xy650 
(See “Octal 


Dump Routine’ 
inSection4 
for values of 
x and y.) 
02000000 
02000001 


02000003 


02000004 


02000006 


02000007 


02000010 


02022222 


04010410 
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Normal, Planned, 


or Error Halt 


Loader Planned 
Loader Normal Planned 
Update Normal 
Loader or Error 
Bootstrap 

Loader 

(MTO only) 

Loader Error 
Loader or Error 
Bootstrap 

Loader 

Loader Error 
Loader Error 
Loader Error 


Loader Planned 


Loader Normal Planned 


Explanation of Halt 


Computer halts when an 
end card with a transfer 
address is encountered, 
This halt occurs only when 
the value of the second 
parameter of the LOAD 
control message so speci- 


fies, i.e. STOP, TSTP. 


Stops in the octal dump 
console driver routine. 


Normal halt when update 
medium is paper tape. 


This halt indicates a buf- 
fer error. 


This halt indicates an 
illegal input format. 


A checksum error has oc- 
curred. 


This halt indicates symbol 


table overflow. 


Unsatisfied external label 

or POP reference remains 
after library search. Un- 
satisfied references and/or 
missing definitions are auto- 
matically output to the type- 
writer or line printer. 


Duplicate external labels or 


POP definitions encountered. 


The computer halts when an 
end record with no transfer 
address is encountered. This 
halt occurs only when re- 
quested (i.e., only when 
the value of the second pa- 
rameter of the LOAD control 
message so specifies). 


Stops in the symbol table 
typeout driver routine. 


Recovery Procedure 


Set RUN-IDLE-STEP switch to RUN 


to execute the program. 


Reset the A and B registers to con- 
tinue the dump operation or set the 
C register to 00100355 (BRU 
RDMSGR) to have the system reada 
contro! message. 


Set the RUN-IDLE-STEP switch to 
RUN. 


Set (A) > 0 if the program just read 
was the last paper tape record and 
clear the halt. 


Set (A) = 0 if the program just read 
was not the last one. Insert next 
program tape into the paper tape 
reader and clear the halt. 


1. For card input, replace the 
misread card in the hopper. 
Set the RUN-IDLE-STEP switch 
to RUN. 


2. For paper tape input, reposition 
the record for re-read. Set the 


RUN-IDLE-STEP switch to RUN. 


3. For magnetic tape unit 0, the 
program automatically tries ten 
times to read the record. Setting 


the RUN-IDLE-STEP switch to 


RUN causes it to try once more. 


Clear the halt to cause the program 
to ignore the record and continue. 


Clear the halt to cause the program 
to ignore the error and continue. 


No recovery. 


]. No recovery; i.e., no way to 
satisfy the references or defini- 
tions. 


2. Clear the halt to ignore the un- 
satisfied labels or references and 


continue. 


Clear the halt to continue. 


Set (A) = load relocation bias of next 
program, and set RUN-IDLE-STEP 
switch to RUN to continue loading. 


Clear the halt to continue. 


Figure 1. MONARCH Program Halts and Recovery Procedures 


Action 


Transfers to object program 
for execution of that pro- 
gram. 


Dumps the next requested 
area to line printer lon 
the W buffer or selects the 
control message medium 
for input. 


Continues update process. 


1, Not applicable. 


NO 


Not applicable. 


wo 


Not applicable. 


Not applicable. 


Not applicable. 


Not applicable. 


1. Not applicable. 


2. Error is ignored. 


Error is ignored. The first 
definition encountered 
will be used. 


Reads next program unit. 


Reloads MONARCH sys- 


tem into core. 


PROGRAM HALTS AND RECOVERY PROCEDURES 


All error messages are self-explanatory and include re- 
covery procedures, whenever recovery is possible. These 
messages are listed on typewriter 1 on the W buffer if 
Breakpoint | is reset or on line printer 1 on the W buf- 
fer if Breakpoint 1 is set. 


As stated previously, control messages may be input from 
cards, paper tape, typewriter, or magnetic tape. However, 
if an error is detected in a control message, typewriter 

l on the W buffer is selected for input (after an appropriate 
error message is output), and MONARCH waits for a new 
control message to be submitted by the operator. 


Figure 1 describes normal, planned, and error halts for 
which no messages are produced. The errors are identi- 
fied by codes placed in the C register. 


SYSTEM OUTPUT 


Parameters of various control messages enable the user 
to specify that certain ‘information be produced during 
or following the operation of portions of the MONARCH 
system. For example, with a LOAD control message 
parameter the user may request a printout of the loader's 
symbol table; via the FORTLOAD control message he 
may specify that a label map, a storage map, and/or 

a trace of the object program be printed. 


MONARCH LOADER'S SYMBOL TABLE 


The MONARCH loader constructs a symbol table during 
the loading of a program. If the parameter TSTP or 
TGO appeared in the LOAD control message, the load- 
er will output this symbol table after the program has 
been loaded. The table is produced on typewriter 1 on 
the W buffer if Breakpoint 1 is reset or on line printer | 
on the W buffer if Breakpoint | is set. For a 900 Series 
computer with a 12K memory, the printout has the for- 
mat shown below. A complete symbol table list is given 
in Figure 3 at the end of this section. "Symbol Table 
Typeout" in Section 4 explains the procedure for producing 
a symbol table for computers with other memory sizes. 


QLPBbbb6 49027764 
QCP3bb6b 49927763 


QCRBbHS5bH 46927762 
QL7BD6bb6 40027761 


QSYSTPbb 4OP27244 
ACCUM16b 499906206 


WDOTY Pbbb 49609212 
EOMbDSbH5 46990213 


The first column contains the 8-character symbols (trail- 
ing blanks are supplied for symbols having fewer than 


eight characters). The first group of symbols, each be- 
ginning with Q, are the loader's external label defini- 
tions that allow the user's program to reference locations 
within the resident portion of MONARCH. Following 
these are the symbols from the user's program. 


The second column lists the numeric codes specifying the 
types of symbols (external label definitions, external 
POP references, etc.) and the locations to which the 
symbols are assigned (the last five octal digits). If the 
first digit (counting from the left) of the numeric code is 
equal to or greater than 4 (i.e., bit position 0 of the 
computer word contains a | bit), the reference is satis- 
fied; if the first digit is less than 4 (i.e., bit position 0 
of the computer word is a 0 bit), the reference is unsat- 
isfied.. If the fourth digit (counting from the left) is 
equal to or greater than 4 (i.e., bit position 9 of the 
computer word is a1 bit), the symbol in the first column 
has a duplicate definition, in which case the first defi- 
nition encountered is used andthe subsequent duplicate 
definition is ignored. See Appendixes C and F for a 
detailed description of the various types of symbols and 
how they are designated. 


FORTRAN LOADER'S OUTPUT 


During the loading of an object program, the FORTRAN 
loader outputs the headings NAME, ENTRY, ORIGIN, 
LAST, SIZE/10, COMMON, and BASE (on typewriter 
1 on the W buffer if Breakpoint 1 is reset or on line 
printer 1 on the W buffer if Breakpoint 1 is set). 


It neither a label map nor a storage map is requested, the 
next output shows the program name, the entry location, 
the origin of the program, the last location of the pro- 
gram, the number (in decimal notation) of locations oc- 
cupied by the program, and (when applicable) the number 
(in octal notation) of COMMON locations. If a label is 
requested, it is output immediately below the headings. 
If a storage map is also requested, it is output following 
the label map. An abbreviated example of the FORTRAN 
loader's output is given in Figure 2. 


The entry, *PROGRAM, is always printed; it identifies 
the line containing the total program storage information. 
$$$$$$$$ is the compiler-assigned identification for the 
main program. 


The value in the column BASE is used to determine the 
exact location of variables. Variables are compiled to 
be stored immediately following the program in which 
they are used. At compilation time, variables are as- 
signed locations relative to the end of the program; it 

is these relative locations which are printed as "Program 
Allocation" by the compiler. To determine the absolute 
location of a given variable, add its relative location to 
the value listed by the FORTRAN loader as "base" for 
the program containing that variable. For example, 
assume the variable J was assigned relative location 55. 
Using the base shown in Figure 2, the absolute location 
of J is determined by adding 04643 and 55, which re- 
sults in 04720. 
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ORIGIN SIZE/10 COMMON BASE 


$$$$555$ 03462 03452 05224 875 04643 
ABSF 05226 05225 05242 14 
203SYS 05244 05243 05254 10 


*PROGRAM 


Figure 2. FORTRAN Loader Output 


QLP35b06 
QCP3Hbbb 
QCRBSHobH 
QL7Bbbbb 
QL6Bbb5b 
QL58bb5b 
QL4BbHbbb 
QL3Bb6bb6 
QL2Bb5b6 
QL136Hb56 
QLOBDbbdbS 
QSYSPbbb 
ABINT bbb 
OSYMObbHD 
ABINOBDS 
ASYSTbHSb 
ASYiALbdb 
NSYSbbHbHb 
NSYS1BH6o 
AS YSUBHS 
QPESWbbb 
NASYLDROb 
N300TbbbB 
QDUMPbbb 
QETBLbObD 
QMS GbbHb 
ASRCHHbbS 
QCWHdddb 
ATAPEDDDb 
QPAPERbDD 
QCARDbbb 
OSYSINbDD 
QSYSTPbbS 
ACCUMI1bDB 


40927764 
49927763 
40027762 
49027761 
40927766 
49927757 
46927756 
496927755 
4OG27754 
49927753 


49927775 
4OO27774 
49927773 
49627772 
40627771 
49927770 
hO$27767 
49927765 
49627776 
4G027777 
40625431 
40627736 
49027646 
46926476 
49927766 
40927104 
4G627246 
40026760 
49026737 
40026714 
49027243 
4Od27244 
49000206 


WDOTY Pbbb 
EOMbDbdDb 
IORELCHD 
PRMCTROB 
METPRCDbD 
CMFDTDbbS 
CADDRbbdb 
MSGbbbbHb5 
RDMSGbbBb 
RDS GRbOb 
HSGRS Tob 
GETWRDbDD 
TY PHbbdDD 
TY POUTbb 
SETbbbbb 
DISPLYbDb 
ASSIGNbb 
LbbHbd566 
3TLDbbdb5 
A38Sbdbbb 
RELBDbDD 
IMESSAGbDb 
MESS PRbBb 
CRDT Pddd 
LOADDdDDB 
FILLSYOb 
JOBMSGbb 
ENDJB5D 
UPDATEbb 
GSYSPbbb 
OMT EDDDH 
SRLDSYbBbB 
CARDDDDS 
MAGT Pbbbd 


49090212 
46666213 
49990231 
49660237 
4OAGG2K2 
49969250 
446900255 
49900256 
46699326 
49990355 


49990576 


49600617 
46661231 
49961231 
4G9O81365 
49001416 
46091470 
49001535 
49981607 
49901617 
49991631 
46991713 
49001734 
49001735 
469620677 
46002216 
49992232 
49602236 
46602242 
46602276 
490602311 
49902313 
4f603560 
4AOO4501 


MTY 1ObDb 
MPRNTbDb 
CODESbbD 
PARAMSDB 
AMS GRDDb 
CHARbbbb 
RBTLDXbbb 
LDI2Xbbb 
CTFDTbbbd 
CT3UFDbb 


LDIOSR2b66 
SYMBARDBB 
METADDDD 
FLPTbbbb 
FORTLAbDS 
FCPTdbb55 
FORTCADDS 
FKPTSbbd 
FORTKADD 
ALGOLAbb 
POSNbbdDdbS 
LABELbbb 
REWINDbBbd 
WEOFDbbb 
BKFILEDDS 
SKFILEbdb 
SKRECBSb 

KRECbBbb 
FORTBIAS 
LDI2bbb6b6 
QENDMNbb 


4OGB4923 
4OOO5241 
49992426 
hOOA2658 
490603277 
49903177 
46997190 
46967865 
4OOO3465 
LOPD3474 


49005549 
49996753 
49966335 
49096225 
LAOO6G44 
49696236 
49995775 
46906224 
4OOP6640 
49096262 
46906617 
49666572 
46096534 
LO GG6542 
4AAG6422 
LPOG6500 
KOOD65H4 
49006511 
49606672 
4f996334 
49997455 


Figure 3. MONARCH Loader Symbol Table (900 Series Computer, 12K Memory) 


APPENDIX A. THE MONARCH UNIT ASSIGNMENT TABLE (UAT) 


To allow the use of the same input/output device for the same function throughout a series of runs, 
MONARCH maintains a table of standard unit assignments in upper memory. Each entry represents, by 
convention, a particular input or output function. For example, in a batch of runs consisting of as- 
semblies and compilations, it is desirable to be able to designate a particular output. unit (e.g., a card 
punch) as the unit on which all object programs are to be written. In the MONARCH system, this unit 
is referred to as the binary output unit (BO) and would be assigned, in this case, BO =CPIW. 


Twenty-one such input/output functions have been designated in the MONARCH system; ten standard 
UAT entries and eleven special purpose Business Language package I/O entries. Additional functions 
may be added at a later date. The format of the unit assignment table entries and a description of the 
functions currently provided are given below. 

Standard SDS I/O subroutines are constructed so that they can make use of the MONARCH unit assign- 
ment table to obtain unit and channel codes for their operation. The reader should consult the description 
of these subroutines for additional information regarding the use of the MONARCH unit assignment 

table. (The program description catalog numbers for these subroutines are shown on the tape listing in 
Appendix B. ) 


At load time the unit assignment table is automatically allocated to the top of core in relocatable form. 
The last word of the unit assignment table is $QPESW, a 1-word entry defined as the job and processor 
error switch (see JOB and ENDJOB contro] messages in Section 2). The format of the words in the 
UAT is illustrated below. The upper portion of each diagram contains identifying symbols which, along 
with their definitions, describe the contents of the word. The lower portion of each diagram shows the 
number of bits reserved to each of these elements. 


Contents 


Number of bits 


A = Job mode indicator: 
0 = not in job mode 
1 =in job mode 


B = Processor error count 


Format of the 1-word unit assignment table entries for 900 Series MONARCH: 


Address of I/O Subroutine 


0 1 2 2:6 8 9 10 23 


U1 U2 = Unit Address Code (5 low-order bits of the 6-bit unit address code) 
C = Channel designator: 
O= W buffer 
1= Y buffer 


Contents 


Number of bits 


Format of the 2-word unit assignment table entries for 9300 MONARCH: 


Word | 
000 000 000 Address of I/O Subroutine 


Contents 


Number of bits 


9 23 
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Word 2 


2s ERROR RE Oa 
D0) a eC See eee 0) ARC a 


9°34 1617/18 '19 


C1 = high-order bit of the 3-bit channel code 
C2 = second highest order bit of the 3-bit channel code 
C3 = low-order bit of the 3-bit channel code 


Contents 


Number of bits 


IAT 


The high speed printers are designated, in UAT entries, by unit address codes of 20, (number 


(number 2). 


STANDARD UNIT ASSIGNMENT ENTRIES 


MONARCH 

External Symbolic 
Function Label Parameter 
Control message input $QMSG -- 
System (MONARCH magnetic tape) $QSYS S 
System scratch $QSYST XI 
System intermediate output scratch (magnetic tape) $QSYSI X2t 
System scratch (magnetic tape) $QSYSP X3 
Encoded output (META-S YMBOL) $QSYSP EO 
Symbolic input (e.g., card reader) $QSYSI SI 
Symbolic output, Update input $QSYSU SO, UI 
Binary input (loader uses this) $QBINI BI 
Encoded input (META-SYMBOL) $QBINI EI 
Binary output (e.g., card punch) $QBINO BO 
List output (e.g., printer) $QSYMO LO 

BUSINESS LANGUAGE UNIT ASSIGNMENT ENTRIES 
MONARCH 

External Symbolic 
Function Label Parameter 
Magnetic Tape Zero $QLOB LO 
Magnetic Tape One $QLIB LI 
Magnetic Tape Two $QL2B L2 
Magnetic Tape Three $QL3B L3 
Magnetic Tape Four $QL4B L4 
Magnetic Tape Five $QL5B L5 
Magnetic Tape Six $QL6B L6é 
Magnetic Tape Seven $QL7B L7 
Card Reader $QCRB LCR 
Card Punch $QCPB LCP 
Line Printer $QLPB LLP 


When a standard processor such as FORTRAN or META-SYMBOL is loaded, MONARCH selectively loads 
any standard I/O subroutines required for I/O functions which the processor is expected to perform. The 
address of each I/O subroutine loaded is stored in the UAT entries whose unit address codes correspond 
to that subroutine. For example, if the magnetic tape I/O subroutine is selectively loaded, its address 
is stored in each UAT entry whose unit address code specifies a magnetic tape unit. 


t 
X2 must be assigned to magnetic tape unit 2 (MT2) under MAGPAK environment when using META- 
SYMBOL. 


MONARCH maintains a list of standard I/O subroutines required for each system action routine, in addi- 
tion to the initial loading address for the first I/O subroutine to be loaded for operation with the system 
action routine. 


MONARCH provides external label definitions for unit assignment table entries which correspond to I/O 
subroutines selectively loaded by the MONARCH loader. 


The I/O subroutines are referred to indirectly through the unit assignment table in upper memory. Unit 
assignments can be made externally through ASSIGN messages. Note that the ASSIGN message does 
not set up I/O subroutine addresses (bits 10 through 14) in UAT entries. 


The Business Language user's program is linked to the Business Language I/O handlers via external 
references and definitions at load time. 


i 
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APPENDIX B. THE MONARCH SYSTEM TAPE 


The MONARCH system tape consists of an ordered collection of programs and data files preceded by a 
special bootstrap loader which itself can be loaded under control of the FILL switch on the SDS 910/925 
Computers, the magnetic tape FILL switch on the SDS 925/930 Computers, and the magnetic tape LOAD 
switch on the SDS 9300 Computer. The bootstrap loader, in turn, loads the MONARCH loader and the 
MONARCH monitor. All programs (or processors) on the system tape except the bootstrap loader and the 
MONARCH loader are preceded by MONARCH ID records. The MONARCH monitor, the MONARCH 
loader and the MONARCH update routine all make use of MONARCH ID records to locate programs or 
data files on a MONARCH system tape. Only the first 16 characters of a MONARCH ID record are 
interpreted by the MONARCH operating system. MONARCH ID records have the following format: 


TEEPE E PEP on wane wre | 
ina a eee cs dleas) es 


Character 
Position 
Contents 


=lor2 

= space 

any alphabetic character 

any alphanumeric character or trailing space (i.e., space not followed by another character) 
any character 


aa os 


Major divisions of a MONARCH system are preceded, on the system tape, by a level 1 MONARCH ID 
record: 


ALAA AAA AT RY GINAME . oui 


Minor divisions are preceded by a level 2 MONARCH ID record: 


D2, AAAASUBRNAME. . . 
Minor divisions of a MONARCH system are arbitrary subdivisions of a program or of a data file that are 
recognized by the MONARCH update routine. Normally, these subdivisions serve only to enable the 
user to update an old system tape at the subdivision level, i.e., to insert, delete or replace one or 
more subdivisions of a program without affecting the remaining subdivisions. Individual subroutines on 
the MONARCH library are also separated by level 2 records both for the MONARCH loader and to 


make it possible to insert, delete, and replace the subroutines individually. 


Program names occurring in level 1 MONARCH ID records must be unique within a given MONARCH 
system tape. Program names occurring in level 2 MONARCH ID records need be unique only within a 
given major subdivision of a MONARCH system tape. The following additional rules apply to the 
program names on a given MONARCH system tape: 


If A and B are unique program names occurring in level 1 MONARCH ID records and X and Y are unique 
program names occurring in level 2 MONARCH ID records, then A, B, X, and Y may be used as program 
names in level 2 ID records of A and/or B. Symbolically this may be represented as 


Deve ld” Cis te eo 


Level2 LAyLByLXyLY LAL ILX ILS 


The last record on a MONARCH system tape is a level 1 MONARCH ID record with the program name 
SYSEND in characters 9 through 14 (15 and 16 must be blank). 


The system tape contains the monitor, the MONARCH loader, the system tape update routine, and other 
standard system routines required by the particular installation using the system. The system tape unit 
must be assigned as unit 0 on the W buffer for the SDS 910/920, unit 0 on channel W for the SDS 925/930, 
and unit 0 on channel A for the SDS 9300. A sample listing of the contents of a system tape for a 920 
computer appears at the end of this appendix. 


MONARCH SYSTEM TAPE RECORDS 


Format of first words of valid system tape records: 


SDS STANDARD BINARY OBJECT PROGRAM RECORD (first word) 


inet _fw cont Word Count ( Folded Checksum (FC) ; 
T ae see 
SAS a | 


Record wae 
iype (1) Word Count (C) Folded Checksum [ 
a. a (12) 


op Space Character Space Character fl 


110 000 110 000 


6 8 9 ii 17 18 23 


A Character - 


101 111 
0 


a BS 


IDL = 001, Major Division - Level 1 ID Record 
IDL =010, Minor Division - Level 2 ID Record 


MONARCH BOOTSTRAP LOADER (first word = WIM 012, 2) 


a 
fo 1 ofo 11.01 ofofo000000000 1010 


MEMORY ALLOCATION 


e .7 . t 
The amount of normal core allocation can be determined with the formula 


QENDMN~ + _ Loader + Symbol Table = size 


(starting address) (length) (length) 
octal decimal 
QENDMN 7455 3885 
Loader Me 2512 1354 
Symbol Table” 454 300° 
Total 12643 Sos? 


"The formula is valid for 9300 Computers; however, the amounts given are for a 900 Series Computer. 


"The symbol table requires three words per definition. 


ds 
ww 


The amount of core allocation during an update run can be determined with the formula:! 


LDIOSR + Loader + Bootstrap Loader + Update + Symbol Table = size 
(starting address) (length) (length) (length) (length) 
octal decimal 

LDIOSR 5540 2912 

Loader 2512 1354 

Bootstrap Loader 260 176 

Update rr 4136 2142 

Symbol Table 454 300 

Total 15344 6884 


The following is a sample tape listing for a 920 Computer. The circled numbers refer to notes at the end 


of the listing. 
Ai Lead ° @ @) 
Gd) Al MONITEGR B 06/24/65 --_ABEL=- 042012 eee 
A? CONTROL 06/24/65 1174 042004 
Ae TABLES 06/30/65 0425 042005 
A2 OMSGRD C4/01/65 0177 042006 
A2 CARD 04/01/65 0162 030004 
A2 MTYIO 04/01/65 0225 020019 
A2 MAGTP G4/30/65 0352 040004 
A2 MPRNT 06/14/65 0191 0600058 
A2 LDIOSR 05/20/65 0157 042007 
A2 FORTACT 04/05/65 0181 042014 
A2 FORTEIAS G4/01/65 0000 042015 
a2 ALGSLA 04/01/65 0041 042017 
A2 LDI2 g6/30/65 0592 042030 
A2 TFMBNRCH 04/01/65 oco2 042008 
al PRINT fy 06/14/65 0191 O60005Becee 
@ Al epeP B 04/01/65 o211 030005 
Al PTYI8 3 04/01/65 0225 o20019 
bi METAG20 N6/30/65 rer 
A2 ENCSLER 3 06/30/65 
a2 MONI B 05/20/65 
a2 MSCONTRL 8 64/01/65 0640 
Az PREASSEM 06/30/65 
A2 PRECOIYU 04/27/65 
A2 PREC920 06/17/65 
A2 PRACO3UO 05/02/65 
A2 PRECB920 65/12/65 
A2 SHRINK 06/30/65 
AZ ASSEMRBLR 06/30/65 
A2 PAS2 06/30/65 
A2 FINISH 06/30/65 
A2 CONCRD 06/12/65 
AZ CE8N2 06/12/65 
At LINKINIT 8 04/22/65 0665 ee 
At LINKZER®6 B 04/22/65 2496 
G) a! FORTRAN a ~--LABELe== 202004H wees 
A2 FCI 04/01/65 3568 
A2 FC2 04/01/65 0449 
A2 FCS 05/14/65 0449 


"the formula is valid for 9300 Computers; however, the amounts given are for a 900 Series Computer. 


"The symbol table requires three words per definition. 


di 


Al 


FERTLGAD 
Pact 
Fle 
FLS 

FERTLIB 
SYS230 
ALGG 
EXP 
ces 
SQRT 
ATAN 
ABS 
IABS 
FLOAT 
IF IX 
SIGN 
ISIGN 
AM@D 
M8D 
AMIN 
CIM 
IDIM 
L@CF 
IF 
EXIT 
LINKING 
SYS160 
SYS201 
SYS202 
SYS203 
SYS204 
SYS205 
SY$206 
$YS$207 
SYS210 
SYS211 
SYS212 
SYS213 
SYS214 
S$YS215 
SYS216 
SYS217 
SYS220 
SYS221 
$YS222 
SYS223 
SYS224 
SYS225 
SYS226 
SYS227 
SYS231 
SYS232 
SYS233 
SYS235 
SYS236 
SYS241 
SYS242 
SYS243 
SYS$244 
SY$245 
SYS776 
SYS777 


04/01/65 
05/24/65 
05/12/65 


04/01/65 
04/01/45 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
U4/01/65 
64/01/65 
04/01/65 
04/01/65 
04/01/65 
C4/01/65 
C4/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
64/01/65 
04/01/65 
04/01/65 
64/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
04/01/65 
64/01/65 
04/01/65 
04/01/65 
C4/01/65 
04/01/65 
04/01/65 
04/01/65 
G4/22/65 
04/01/65 


~*_ASELeaee 
0231 
0253 
0025 
~"-LABELa== 
0108 
0136 
0144 
0203 
0083 
0256 
0013 
0013 
o0c4 
0008 
0021 
0020 
0013 
000gg9 
0065 
0010 
0010 
0004 
0025 
0010 
0010 
0013 
0004 
0008 
0009 
0019 
002i 
0011 
002i 
0010 
0053 
0033 
oocg9g 
0009 
0006 
0036 
0005 
0074 
000s 
0057 
0007 
0006 
0046 
0026 
0019 
0003 
0003 
0028 
0036 
0230 
0349 
0057 
0046 
0018 
0445 
1122 
1472 


012015 


202006 


FORTRAN 


Library 


202005H 


iN 
O 


6) a1 
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Al 


A2 
se 


A2 
A2 


LIBRARY 
CDRP 
CDP 
PIYLe 
PRINT 
MTAPE 


5 
BDD 


BFS 
BDF 
DBD 
DFS 
CBF 
BID 
DIB 
LOG 
LGF 
EXP 
EXF 
ATN 
ATD 
ATF 
csD 
CSF 
ces 
Dsa 
FSQ 
SOR 
FFF 
FSN 
FLD 
DPN 
DPD 
LDP 
STD 
LTP 
STP 
Lap 
STQ 


TRACE 


SYMBOL 


LOADER 


PSI 
CSI 
MS] 
Pee 
cae 
MBS 
TLS 
LL 
MLO 
$1 
S2 
S3 
M910 
M920 
M9300 
MENTIA 
TRACE 
RECON 
PRINTDGN 
UPDATE 


BOe@TSTRAF 
UPDATERT 


ALGOL 


ALG6L1 
ALGOLX 


OoOmuoao wa 


a 


04/01/65 
04/01/65 
04/01/65 
06/14/65 
04/01/65 
G7/01/65 
07/01/65 
07/01/65 
G7/901/65 
U7/U1/65 
07/01/65 
07/01/65 
G7/01/65 
G7/01/65 
U7/G1/65 
07/01/65 
O7/01/65 
07/01/65 
07/01/65 
07/01/65 
07/01/65 
07/01/65 
07/01/65 
07/01/65 
07/01/65 
07/01/65 
C7/61/65 
G7/01/65 
07/01/65 
O7/01/65 
07/61/65 
07/01/65 
07/01/65 
07/01/65 
07/01/65 
07/01/65 
07/01/65 
04/01/65 


95/06/65 


06/20/65 
05/06/65 
05/06/65 
05/06/65 
05/06/65 
05/06/65 
05/06/65 
05/06/65 
C5/06/65 
05/06/65 
06/27/65 
05/06/65 
05/06/65 
05/06/65 
05/06/65 
05/06/65 
05/12/65 
04/01/65 
05/18/65 


10/09/64, 


04/01/65 
04/22/65 
04/01/65 
04/61/65 
04/01/65 


“=LABELen= 
O211 
0162 
0225 
0191 


O35! 
0124 


wet 


0075 
0171 
0178 
o0s2 
0169 
OG97 
9083 
0048 
0152 
0062 
0159 
0057 
0158 
0249 
0148 
0217 
0032 
0082 
0071 
0084 
0082 
0124 
0208 
0010 
0076 
0006 
0066 
ocoe 
oco9 
0010 
0011 
0544 


2408 
0544 
1773 


~-"LABELeoe 
014) 
1619 
~-LABEL ene 
4582 
0501 


20200380 
050005 
Of0004 
YU20019 


O0600058 


040004 

2030378 
2030148 
2030398 
2630368 
2030158 
2030388 
2030128 
2030138 
2030098 
203024C 
2036088 
203025C 
2030078 
2030328 
203026C 
2030348 
203028C 
2030188 
2030358 
2030298 
2030198 
203011C 
2030108 
203023C 
2030228 


2030228 
2030228 
2030208 
2030208 
2030218 
2030218 
2600038 


META- 
SYMBOL 


Library 


2033 


29027 
2006 


2030728.0408,0178.016B 


OCO017C.... 
260003Re eae 
COOO2Z2A.eee 


042009 
042011 
242008 
042018 
042019 


dt 


Al 


ALGOLGAD 04/01/65 -=LABEL=--= =~ 
RL B 04/01/65 0883 242009 
INPUT 04/01/65 0036 0420206 
SUTPLUT 04/01/65 0036 042021 
ENDIE 04/01/65 0007 012019 
ENDYT@L 04/01/65 0006 012020 
ACCTAP G4/01/65 0014 012021 
PNCHTP 04/01/65 oo0a& 012022 
ACCEPT 04/01/65 0020 012023 
TYPE U4/01/605 0008 012024 
READ G4/01/65 0035 032002 
PUNCH 04/01/65 0045 032003 
PRINT 04/01/65 0074 062003 ALGOL 
READIT 04/01/65 0073 042022 Library 
wRITOT 04/01/65 0056 042023 
REWRTP 04/01/65 0360 042025 
REWIND 04/01/65 0012 042024 
SETIGT 64/01/65 0056 042N26 
TSTWRT 04/01/65 0046 042027 
TREADY 04/01/65 0017 042028 
INI TFS 04/01/65 0029 012025 
ABS 04/01/65 0014 012026 
SQRT 04/01/65 0083 212005 
1ExXP 04/01/65 0154 212006 
LN 04/01/65 0011 012028 
EXP 04/01/65 oo1l 012027 
LGF 04/01/65 0145 212018 
EXF 04/01/65 0151 212007 
SIGN 04/01/65 9022 012029 
SINCES 04/51/65 9200 212009 
ARCTAN 04/01/65 0261 212010 
MIN 04/01/65 0015 012030 
MAX 04/01/65 0015 012031 
MeD 04/01/65 0023 012030 

ALGERUN B 64/01/65 --_ ABEL === 
EXEC 04/01/65 1662 242011 
FSCAN 04/01/65 1371 212012,13,1 
LIST 04/01/65 0355 242010 

SYSEND 


If CONTROL routine is replaced (see "System Update Routine" in Section 4), the Al MONITOR 
label card must precede the A2 CONTROL card and the binary deck; this rule is generally true 
for the first program in each logical file. 


As a general rule, any record read by the MONARCH loader can be blocked (see "System Update 
Routine"); a blocked record is identified by the letter B in column 22. Columns 21, 23 and 24 
must be blank. 


Columns 25 through 72 may contain comments. In this listing, the comments are program approval 
date, core allocation, and catalog number. The statement -- LABEL -- in the core allocation 
column indicates the beginning of a logical file. 


The four I/O handlers, PRINT, MTAPE, CDRP, and PTYIO, must appear in this order on the system 
tape and must follow immediately after TFMONRCH; i. e., no insertions may be made between any 
two of these subroutines or between TFMONRCH and PRINT. 


FORTRAN II is available only on 900 Series Computers. 


Any routine or processor that is to go on the system tape should be written prior to the library if it 
has any references to be satisfied from the library. 


. ‘mia od eae, pagal oh cs al. 
ry may have an END card with a transfer address as the 


Q 


No programs within the scope of 


last card in a binary record. 
The ALGOL system is supplied only on specific request. 
An EOF mark is written after SYSEND. 
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APPENDIX C. LOADER OPERATIONS 


A general description of the MONARCH loader is given in Section 3. This appendix explains the main 
features of the loader in greater detail. 


RELOCATION AND DATA RECORDS 


A data record (record type 0) contains instructions and/or data to be stored in memory by the loader. 
Each data record contains a load address which is either the relative or absolute memory location in 
which the first data word (an instruction or a constant) is to be stored. The word in the data record 
containing the load address also contains an indicator that specifies whether or not the current load 
relocation bias is to be added to the given load address to obtain an effective load address. In other 
words the indicator specifies whether or not the data record contains relocatable words. 


The effective load address determines the location in which the first data word is stored; successive 
data words are then stored in consecutive memory locations following the first word. 


Relocation is performed according to the type of record being loaded. Four types of relocation are 
possible; these are described below. Record types are explained in Appendix F, "SDS Standard Binary 
Language. " 


LOAD RELOCATION 


If the load relocation indicator is "set" for a given data word, the initial contents (i) of the rightmost m 
bits in that data word are replaced with k where: 


k = (i +b) modulo 2™ 

m = 14 for SDS 900 Series Computers 

15 for SDS 9300 Computers 

b = current value of load relocation bias 


COMMON RELOCATION 


If the blank COMMON relocation indicator is "set" for a given word, the initial contents of the 
rightmost m bits in that data word are replaced by k where: 


k = (b +c) modulo 2™ 
m = 14 for SDS 900 Series Computers 
= 15 for SDS 9300 Computers 
c = current value of COMMON relocation bias 
b = current value of load relocation bias 


PROGRAMMED OPERATOR RELOCATION 


If the POP relocation indicator is "set" for a given data word, the initial contents (n) of bits 3 through 8 
of that data word are replaced by p where: 


p = operation code from POP table entry number n 


(p20) (O<n = 77g) 


Note: nis the "relative" POP operation code and p is the effective POP operation code computed by 
the loader. 


SPECIAL I/O RELOCATION 


If the special I/O relocation indicator is "set" for a given data word, the following modifications c 
performed: 


1. The rightmost m bits of d are replaced with k and the result is stored ina. 
2. Bit 18 of the contents of a -b is replaced with 5 and the result stored ina -b. 
where: 


d = initial value of the data word 

= effective load address of d 

= initial value of rightmost m bits of d 
current value of load relocation bias 
= 14 for SDS 900 Series Computers 

15 for SDS 9300 Computers 

k = (i +b) modulo 2™ 

5 = bif (i tb) 2=2™ or O if (i +b) < 2™ 


EXTERNAL LABEL REFERENCES AND DEFINITIONS 


The loader is capable of handling (resolving) symbolic cross-references between separately assembled 
and/or compiled programs. External reference and definition items in binary records (type 1 records) 
provide the loader with the information needed to link together two or more separately assembled or 
compiled programs. 


30-8 
II 


During the loading process, the loader maintains a (symbol) table of external label definitions and unsat- 
isfied external references. There is no restriction on the order in which the definition of a label and the 
reference(s) to it appear in the input to the loader. The definition of a label may precede, or follow, 
some or all of the references to it. Note that it is permissible for any number of programs to contain 
references to a given label, provided that one program being loaded contains an external definition item 
for that label. 


When the loader encounters an external definition item, it searches the symbol table for a previous defi- 
nition of that label in the table; if there is one, the loader increments the duplicate definition counter 
and discards the new definition. If the search reveals that the label is already in the table as an un- 
satisfied reference, the loader uses the definition to satisfy all the references to that label and replaces 
the unsatisfied reference item in the table with the definition item. However, if that label does not 
occur in the symbol table (as a reference or as a definition), the loader inserts the external definition 
item in the symbol table. 


The operand field of an instruction which references an external label requires special consideration. At 
the time of assembly, the operand field in this case will contain either zero or the relative address (in the 
same program) of the previous instruction which referenced that same external label. 


A typical assembly containing references to an externally defined label EXLABL might appear: 


*01002 07600000 LDA EXLABL 

*01172 23501002 STA EXLABL, 2 

*01205 07701172 EAX EXLABL 
END 

EXLABL 1205 


oS 
a?) 
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At load time the loader uses the relative address (1205) of the last instruction containing a reference 
to EXLABL to down-chain (i.e., chain back through) the program (to 1172, to 1002), thus determining 
all instructions that reference EXLABL. The zero address portion of the instruction at 1002 indicates 
to the loader the end of the chain in that program. 


Use of EXLABL + 2 in a source program could cause the loader to chain back to the wrong instruction, 
and for that reason external labels cannot be modified in this way af assembly time. However, since 
indexing and indirect addressing are modifications occurring at execution time, they are legal with 


externally defined labels. For example, to access the locations EXLABL and EXLABL + 1 (EXLABL 


externally defined), the following technique might be used. 


The code: would be equivalent to: 
EAX EXLABL LDA EXLABL 
LDA 0,2 STA TEMP 
STA TEMP LDA EXLABL + 1 
LDA 1,2 STA TEMP + 1 
STA TEMP + 1 

TEMP ~~ RES 2 

END 


When the loader encounters an external reference item, it searches the symbol table to see if it already 
contains an external reference item for that label; if so, the external reference chain associated with 
the new external reference item is "linked" to the external reference chain associated with the existing 
table entry and the new external reference item is discarded. If the search reveals that the label is 
already included in the table as an external definition, the loader uses the definition to satisfy all the 
references to that label and then discards the external reference item. However, if that label does not 
occur in the symbol table (as a reference or as a definition), the external reference item is inserted in 
the symbol table; to be satisfied by a later definition. 


EXTERNAL PROGRAMMED OPERATOR REFERENCES AND DEFINITIONS 


The loader is capable of satisfying references to internal and external Programmed Operator (POP) defi- 
nitions. External POP definition items, external reference items, and internal POP definition items 
provide the loader with the information needed to: 


1. Satisfy external and internal POP references. 
2. Maintain external POP reference and definition items in the loader's symbol table. 


3. Construct a Programmed Operator transfer table in cells 0100, through 0177 


8 8° 
An "internal" POP definition is one that is recognized only within the scope of the program in which 
if occurs. No entries are made in the loader's symbo! table for internal POP definitions or references. 


Many of the loader functions performed in the processing of external POP references and definitions are 
also performed (by the same loader subroutines) for external label references and definitions. In parti- 

cular, the functions of insertion and replacement of symbol table entries and the handling of duplicate 

definitions are the same both for external label and external POP items. 


An internal POP definition supplies the loader with the (relative) sequence number that appears in bits 

3 through 8 of data words referencing that POP and the address of the origin of the POP subroutine which 
corresponds to that sequence number. The loader assigns a new sequence number X (0 © X S 77.) which 
it will use to replace bits 3 through 8 of all data words containing references to that POP definition. 

The loader also stores the address of the POP subroutine in the address field of cell X + 100,. The 
reason for assigning new sequence numbers is to avoid possible conflicts with sequence numbers assigned 
in other, separately assembled (or compiled) programs that are also being loaded. A given POP 


mnemonic (e.g., FLA) will be given a unique sequence number during loading, so any reference to FLA 
will "quote" this sequence number. It should be noted that the method depends on the assignment of 
sequential numbers, beginning with zero, to each different POP reference or definition in a given 
program. 


The primary difference in the treatment of internal and external POP definitions is that the external POP 
definition is represented in the loader's symbol table and hence it is recognized as a definition in all 
programs being loaded, not just the one in which it occurred. All of the remarks in the preceding para- 
graph relating to internal POP definitions apply equally to external POP definitions. 


External POP reference items are inserted in the symbol table if no matching definition is found as a 
result of the symbol table search. When a matching external definition is supplied, the operation code 
assigned by the loader and the POP subroutine address are used by the loader to satisfy the reference. 
The POP operation code (X) replaces bits 3 through 8 of all data words containing references to that 
POP, and the POP subroutine address replaces the contents of the address field of cell X + 100,. (See 
Programmed Operator Technical Manuals. ) 


SYMBOL TABLE ITEM FORMAT 


Each item in the loader's symbol table consists of a two-word symbol followed by a one-word value. 
The symbolic portion of a symbol table item consists of from one to eight alphanumeric characters, 
left justified within two computer words. Unoccupied character positions contain blanks (060). 


The value portion of a symbol table item may be one of seven types. In each case, the left-most 9 
bits identify the type and the right-most 15 bits contain the value. 


ST = Subtype 
C = Code 
L = O for label items 


= | for POP items 

M = Ono doubly defined symbol 
= 1 doubly defined symbol 

V = Value 


Internal POP definition 


7 8 9 


C = 1ifV contains program length 
1 if V contains length of labeled Common 


I 
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External Label Reference 


1 0 8) 0) Label Value 


Oo 1 2 78 9 23 


In the 900 Series MONARCH loader, bit 9 of the value word for a given entry in the symbol table is set 
toa 1 bit if the external definition associated with that entry has a duplicate definition. In the case 
of the 9300 MONARCH loader, bit 5 is of the value word is set to a 1 bit. 


Labeled Common Reference 


0 12 78 9 23 


External POP Reference 
0 12 7 8 9 23 
External POP Definition 


io) 6-Bit Op Code i POP Subroutine Origin 
0 1 2 


P89 23 
In the 900 Series MONARCH loader, bit 9 of the value word for a given entry in the symbol table is 
set toa 1 bit if the external definition associated with that entry has a duplicate definition. 


Note: Items whose subtype is 00 are not entered in the table. POP items whose subtype is 11 are not 
entered in the table. 


The origin of the POP subroutine is stored in the address field of the actual POP transfer table entry, 
at X + 100g, when a POP definition is encountered. The actual 6-bit POP address (X) replaces the 
sequence number when the item is inserted in the symbol table. 


Zero is stored in the address field of the actual POP transfer table entry (X + 109g) when a POP reference 
item is inserted in the symbol table. The actual operation code replaces the sequence number. 


The actual 6-bit POP operation code is also stored in the instruction code field of the POP transfer 
table entry whose address is obtained by adding 100, to the sequence number. 


APPENDIX D. UPDATING META-SYMBOL ON MONARCH TAPES 


Any portion of META-SYMBOL may be updated using the standard MONARCH ASSIGN, UPDATE, and 
COPY control cards. However, two sections of the system contain more than one deck, and during an 
update all portions of the labeled segment must be updated. These sections are (1) ENCODER (includes 
ENCODER, the proper POP deck, and S4B), and (2) MONI] (includes MON] followed by the absolute 


loader). 


When modified through reassembly, PREASSEM, SHRINK, ASSEMBLR, and FINISH must be converted 
to absolute form before being placed on the system tape. If the changes are by means of binary patches, 
the patches are inserted at the end of the absolute deck, just preceding the end card. 


If the S4B portion of the ENCODER increases in size by more than a few words, the origin of the tables 
generated by the ENCODER must be changed. To move these tables, reassemble the ENCODER modifying 
the symbol TABLES defined at the end of the ENCODER by an EQU directive. 


If the size of ASSEMBLER increases in size, the constant DTAB in the preassembler must be changed. This 
can be done by inserting a binary patch redefining this constant as needed. DTAB is the origin of the 
encoded dictionary. 


If the size of the MSCONTROL program is increased, it is necessary to reassemble and move everything 
following it including the ENCODER, parts 1 and 2 of PREASSEM, and part 1 of ASSEMBLER. If this 
becomes necessary, the constants CPO, BPO, HED, CSEQ, and CORG must be appropriately redefined 


in both parts of PREASSEM, and the constants LITAB and PACKL must be redefined in part 1 of ASSEMBLER. 


The origins of these programs will also change. 


A more thorough discussion of modification procedures may be found in the META-SYMBOL Technical 
Manual, SDS 900827. It is assumed that anyone attempting source level modification of META-SYMBOL 
will be familiar with that document. 


nr 


QQ) 


54 


APPENDIX E. FORTRAN LINKING 


FORTRAN linking is available only when FORTRAN II is part of the MONARCH operating system. This 
operating system provides a modified Run-Time package, an initialization routine (LINKINIT), an ad- 
ditional subroutine (LINKING) for the FORTRAN library, and an additional control message (FORTLINK) 
for MONARCH. 


FORTRAN linking allows the segmenting of FORTRAN programs and the loading and executing of these 
segments or "links" selectively under program control. A link is made up of a FORTRAN main program, 
subprograms, and FORTRAN library subroutines and functions. The loading of any link automatically 
erases the previous link. Only COMMON, modified FORTRAN Run-Time, and the MONARCH resident 


remain undisturbed during loading of a link. 


Briefly, the FORTRAN linking procedure creates a link by loading a compiled FORTRAN program into 
core with necessary library subroutines and writing this program as an absolute dump preceded by a nu- 
merical identification (ID) on tape. The run-time package is not written on the tape. After all links 
have been written in this manner, each with its own unique ID, LINKZERO is loaded from the system 

tape and scans the linking tape, builds a table of ID's in the order of their appearance on the linking 
tape, inputs an initial list of the linking ID's to be followed at execution time, and executes the first 
specified link. The sequence of links to be executed is determined from CALL statements in the FORTRAN 
program (e.g., CALL LINK (N), CALL NEXT LINK, etc.). 


Links may be written onto a separate magnetic tape or onto the MONARCH system tape itself. The link 
tape must be at 200 BPI density. It is suggested that, if links are to be written on the system tape, a 
special system tape should be created, blocked at 256 words per block, 200 BPI density, containing 
only the MONARCH monitor, I/O handlers, all portions of the FORTRAN system, the update routine, 
and SYSEND. 


LINK PROCESS 


Each of the various links in a chained programis a complete FORTRAN main program using any FORTRAN 
subprograms and library subroutines required. When control is passed from one link to another, the new 
link completely destroys the old one and execution begins at the first executable statement of the new 
main program. Only variables in COMMON are passed from one link to another. Care should be ex- 
ercised that no link is large enough to overlay the COMMON from a previous link that may be needed 
by a following one. The easiest way to assure this is to reserve the same amount of COMMON in each 


link. 


After all the desired links have been stored on magnetic tape, a chaining sequence is initiated by re- 
questing LINKZERO (i.e., via a LOAD 0, GO, 'LINKZERO' message). LINKZERO is loaded complete 
with a modified Run-Time package and the linking routine. The modified Run-Time package remains in 
memory to be used by succeeding links; the other links do not have Run-Time associated with them. 
LINKZERO determines the initial sequence of links to be performed and calls the first one into memory. 
The linking routine contains a push-down list of link numbers. Statements are provided for adding and 
removing links from the list and for calling them into memory. Any link may use the following statements: 


1. CALL LINK (3) 
Call in link number 3. (The ID number for a link may be any three decimal digits.) The actual 
procedure here is to put 3 at the top of the push-down list and then call that link, which re- 
moves the number from the list. 


2. CALL LINK (integer variable) or CALL LINK (integer expression). 


3. CALL LINK (expression 1, expression 2, ..., expression n). 
Compute the n expressions (where n has a maximum value of 30) and place the resulting numbers 
at the top of the push-down list so that they will be called in the order 1, 2, ..., n before 
calling whatever was on the list previously. Note that 2, above, is a special case of this. 
Zero is a legitimate link number and, when called, causes a return to MONARCH. 


4, CALL LINK (-2) 
Remove the top two items from the push-down list. Do not call any link but proceed to the 
statement following the call. 


5. CALL LINK (negative expression 1, expression 2, expression 3, ..., expression n) 
If the first number is negative, remove the appropriate number of links from the push-down list 
before proceeding to enter the following numbers. Then call the link specified by expression 2. 
Only the first number may be negative. An error message (NEG. ARG) will result if any others 
are negative. Note that 4, above, is a special case of this. 


6. CALL NEXT LINK 
Call the link specified by the top number in the push-down list and remove that number from 
the list. If the list runs out of numbers, control is returned to MONARCH. 


No parameters are used following CALL NEXT LINK. If present, they are ignored. 
7. CALL FILL LINK (expression 1, expression 2, ..., expression n) 
Compute the n expressions, place the resulting numbers at the top of the push-down list, and 


return to the calling program. 


When a link is called, it always begins at the first executable statement. However, one can effectively 
make it start at any number of places by providing a transfer instruction as the first executable statement: 


1. Label the appropriate statements (e.g., 16, 2, 19). 


2. As the first statement in the link, write a computed GO TO statement which references a loca- 


tion in COMMON; e.g., GO TO (16, 2, 19), I where I is in COMMON. 


3. In the calling program prior to the CALL LINK statement, set the COMMON location (i. e., I) 
equal to the value of the desired label (in this example, I would be set to 16, 2, or 19). 


GENERATING A LINK TAPE 
The MONARCH control message FORTLINK has the format 


APORTUINK Pp (Paicaiyahs 


P The identification number to be assigned to the link about to be written on magnetic tape; may 


be any three decimal digits. 


P59 Same as P. for FORTLOAD. 


The FORTLINK control message causes MONARCH to load and transfer control to the FORTRAN loader, 
which in turn loads a FORTRAN-compiled program and produces a storage map and/or label map as 
specified by the parameters P5 through Pg. Then that FORTRAN-compiled program is written onto the 
link tape as link number P}. The links do not have to be written in numerical sequence. 


The program always uses X2 as the link tape; therefore, X2 must be assigned to a magnetic tape unit 
before MONARCH encounters the FORTLINK control message. X2 may be assigned to any tape unit 
including the MONARCH system tape. The link tape must be at 200 BPI density. It is suggested that, 
if links are to be written on the system tape a special system tape should be created, blocked at 256 
words per block, 200 BPI density, containing only the MONARCH monitor, I/O handlers, all portions 
of the FORTRAN system, the update routine, and SYSEND. 


The links themselves consist of two records. The first record is a 10-word record containing the link 
number. The second record is the core dump of the FORTRAN program. The core dump does not include 
the FORTRAN Run-Time package. 


[o,) 
On 
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When completed, the linking tape will consist of: an end-of-file mark, a short record and a long record 
for the first link, a short record and a long record for the second link, etc., and then finally another 
end-of-file mark. It makes no difference whether the link tape is the system tape or a separate scratch 
tape. As far as the operation and execution of a linked program is concerned, the links are bracketed 
by end-of-file marks. 


EXAMPLES 
Example A: 


AASSIGN X2=MT3W, BIEMTOW, 
ALOAD 0, GO, 'LINKINIT'. 
AASSIGN X1=PRIW. 
AFORTLINK 29, MAP, X1. 
AFORTLINK 16, X1, X1. 


The link tape is to be on magnetic tape unit 3. The binary input is from the system tape. The LOAD 
control message causes the linkage initialization routine LINKINIT to be loaded. Magnetic tape 3 is 
rewound, two end-of-file marks are written on it, and the tape is rewound again. Control is then 


transferred to MONARCH, which makes the new unit assignment for X1 and loads the FORTRAN loader. 


The FORTRAN loader loads the previously compiled FORTRAN program from the paper tape reader and 
produces a storage map of the program. The library is loaded from the system tape and the message 
"LOADING COMPLETE ..." is typed. Next, magnetic tape 3 (i.e., the link tape X2) is scanned for- 
ward to the second end-of-file mark; the tape is then backspaced over this end-of-file mark. The 
FORTRAN program, which was just loaded, is written onto the tape as link number 29, another end-of- 
file mark is written, and the tape is rewound. The message "LINK WRITTEN ON TAPE" is typed and 
control is returned to MONARCH. 


The effect of the second FORTLINK contro! message is similar to that just described except that no map 
is produced and the previously compiled programs are on two separate pieces of tape (possibly a main 
program and a function). After the programs are loaded and the message "LOADING COMPLETE ..." 
is typed, magnetic tape 3 is again scanned forward to the second end-of-file mark; the tape is back- 
spaced over this end-of-file mark. Then the FORTRAN program just loaded is written onto the tape as 
link number 16, another end-of-file mark is written, and the tape is rewound. 


This process can continue until all the links have been written on tape. There is no restriction on the 
links except that no two links may have the same identification number. 


Example B: 


AASSIGN X2=MTOW, BI=MTOW. 
ALOAD 0, GO, 'LINKINIT'. 
AASSIGN X1=PRIW. 

AFORTLINK 17, MAP, LMAP, X1. 
AFORTLINK 169, X1, X1U. 


In this example the system tape is to be used as the link tape. After the linkage initialization routine is 
loaded, the system tape is scanned forward to the first end-of-file mark, and a second end-of-file mark 
is written. Then the system tape is rewound, and control is transferred to MONARCH, which makes the 
new unit assignment for X1 and loads the FORTRAN loader. 


The FORTRAN loader loads the previously compiled FORTRAN program from the paper tape reader, loads 
the library routines from the system tape, and produces a storage map and a label map. After the mes- 
sage "LOADING COMPLETE ..." is typed, the system tape is scanned forward to the second end-of- 
file mark and backspaced over this end-of-file mark. The just-loaded FORTRAN program is written onto 
the system tape as link number 17, another end-of-file mark is written, and the system tape is rewound. 
The message "LINK WRITTEN ON TAPE" is typed, and control is transferred to MONARCH. 


The effect of the second FORTLINK control message is similar to that just described except that the 
previously compiled programs are on two separate pieces of paper tape. The second piece of tape is 
to be read unconditionally. After the programs and library subroutines are loaded, the message 
"LOADING COMPLETE..." is typed. The system tape is again scanned forward to the second end- 
of-file mark and backspaced over it. Then, the just-loaded FORTRAN program is written onto the 
system tape as link number 169, another end-of-file mark is written, and the system tape is rewound. 
The message "LINK WRITTEN ON TAPE" is typed, and control is transferred to MONARCH. 


This process may continue until all the links have been written on the system tape. 
Example C: 


AASSIGN X2=MT2W, BI=MTOW. 
ALOAD 0, GO, 'LINKINIT'. 
AASSIGN SI=PRIW, BO=MTIW, LO=LPIW. 
AREWIND MTIW. 

AFORTRAN LO, BO. 

AREWIND MTIW. 

AASSIGN BI=MTIW. 
AFORTLINK 2, BI. 

AREWIND MTIW. 

AFORTRAN LO, BO. 

AREWIND MTIW. 

AFORTLINK 4, MAP, LMAP, BI. 


In this example magnetic tape 2 is the link tape. The binary input is from the system tape to enable 
the loader to load the link initialization routine. The link tape is rewound, two end-of-file marks 
are written, and the tape is rewound again. Then control is transferred to MONARCH, which makes 
the unit assignments for the SI, BO, and LO units and rewinds magnetic tape 1. 


Next the FORTRAN compiler is brought into core. The compiler accepts the source input from the 
paper tape reader, compiles the program, produces a listing on the line printer, and writes the com- 
piled program onto magnetic tape 1. Then control is returned to MONARCH, which rewinds mag- 
netic tape 1 and makes a new unit assignment for the binary input unit. 


The FORTRAN loader is brought into core, and it loads the previously compiled program from magnetic 


tape 1. After the program and any necessary library subroutines have been loaded, the message 
"LOADING COMPLETE..." is typed. Next, the link tape is scanned forward to the second end- 
of-file mark and backspaced over it. Then, the just-loaded program is written onto tape as link 
number 2, another end-of-file mark is written, and the tape is rewound. Control is transferred to 


MONARCH, which rewinds magnetic tape | and calls in the FORTRAN compiler again. 


The compiler accepts the second source program from the paper tape reader, compiles it onto mag- 
netic tape 1, and produces a listing on the line printer. Then control is returned to MONARCH 
which rewinds magnetic tape 1 and calls in the FORTRAN loader. 


The FORTRAN toader loads the compiled program from magnetic tape |. The link tape is scanned 
forward to the second end-of-file mark and backspaced over this mark. Then the just-loaded pro- 
gram is written onto the link tape as link number 4, another end-of-file mark is written, and the 
tape is rewound. 
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EXECUTING A LINKED PROGRAM 


Execution of a linked program is initiated when the routine LINKZERO is called into core via a LOAD 
control message. The LINKZERO routine 


1. Scans the link tape to determine how many links are present and the order in which they 


appear on the tape and to record the identification numbers (link numbers) of the first 
thirty links. 


2. Positions the tape between the two end-of-file marks that define the beginning and end of the 
link tape. 


3. Stores information indicating the order in which the links are to be executed. 
4. Locates the link to be executed first, loads it into core, and transfers control to it. 
During the execution of the user's program, the links are located on the link tape by one of two methods: 


1. If the link is one of the first thirty on the tape, its location will be known, and it can be lo- 
cated and read into core directly. 


2. If the link is not one of the first thirty, its location is unknown; therefore, the link tape is 
positioned in front of the first link and is scanned forward until the desired link or an end-of- 
file mark is found. 


If the link cannot be found, an error message (EOF STOP) is typed, and the computer halts. The link 
number for which the search was unsuccessful is displayed in the A register. 


Example: 


AASSIGN X2=MT2W, BI=MTOW, SI=TYIW. 
ALOAD 0, GO, 'LINKZERO'. 


After LINKZERO is loaded into core, the message "LINKZERO LOADED" is typed. The link tape X2 
is scanned forward to the first end-of-file mark. The tape is then read to determine the order of the 
first thirty links. This information is stored in a 30-word table. (More than thirty links may be written 
on the tape, but only the first thirty identification numbers are stored in the table.) After this informa- 
tion is stored, the tape is positioned in front of the first link on the tape. From this point on, the tape 
remains positioned between the two end-of-file marks that delimit the links. 


LINKZERO then accesses whatever symbolic input device has been assigned —in this example, the 
typewriter. The user enters the list of link numbers in the order in which the links are to be executed. 
(Links may be executed any number of times and in any sequence.) This information is stored in a sec- 
ond 30-word table. The list of link numbers is entered under FORTRAN FORMAT (14). The user must 
enter at least one link number; a maximum of thirty may be entered. (This feature enables the user to 
specify the first link and then have the links executed under program control; i.e., the first link calls 
another link which calls another, etc.; or the user may specify, via the input device at execution time, 
the order in which the links are to be executed, and each link is written to call the "next" link rather 
than a specific one.) The first link number entered by the user will be the first link executed. 
LINKZERO locates this link on the link tape, loads it into core, and transfers control to it. 


APPENDIX F. SDS STANDARD BINARY LANGUAGE 


The following description specifies a standard binary language for SDS 900 Series and 9300 Computers. 
The intention has been that this language be both computer-independent and medium-independent. Thus, 
the language provides for handling Programmed Operator definitions and references even though the 9300 
does not have this hardware feature; similarly, there is a provision for relocation relative to blank 
COMMON, even though this requirement is not present in SDS 900 Series FORTRAN II. 


In the following description of the language, a file is the total binary output from the assembly/compi- 
lation of one program or subprogram. A file is both a physical and a logical entity since it can be sub- 
divided physically into unit records and logically into information blocks. While a unit record (in the 
case of cards) may contain more than one record, a logical record may not overflow from one unit record 
to another. 


1. 


CONTROL WORD — first word in each type of record 


Word CoumbiCy sere Folded Checksum (FC) Field 
(Binary) 
of to PY Conte 
0 23 4 8 9 11 12 23 Bit Number 
T Record Type 
000 Data record (text) 
001 External references and definitions, block and program lengths 
010 Programmed Operator references and definitions 
01] End record (program or subroutine end) 
100 


Not assigned 
" 1 
C = total number of words in record, including Control Word 
Note that the first word contains sufficient information for handling these records by routines other 
than the loader (that is, tape or card duplicate routines). The format is also medium-independent, 


but preserves the Mode indicator positions desirable for off-line card-handling. 


An exclusive OR checksum is used. If the symbol -- is used to denote exclusive OR, and W. denotes 
the i-th word in the record (1 <i < C), then 


FC = Wo] -- (S) 944 -- (S) 12-23 7~ 07777 
where 


S = Wo == Wa eee Ww. 


DATA RECORD FORMAT (T=0) 


Word |] 


Control Reeerd 
Word Type (T) 
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Word 2 


" 
Load V) Data Word jLoad Address g 

Addrexe Y Modifiers (M) {Modifiers (A) Load Address (Relative or Absolute) 

PTO ese eh et cee ae eed 


cua 4°5 8' 9 23 


The presence of bits in field M indicates the presence of words n + 3, n+ 4, n+5, and n+ 6(shown 
below): 


If bit position 4 contains a 1, word n + 3 (load relocation) is present. 

If bit position 3 contains a 1, word n + 4 (common relocation) is present. 

If bit position 2 contains a 1, word n + 5 (POP relocation) is present. 

If bit position 1 contains a 1, word n + 6 (special I/O relocation) is presen’. 


Word 3 


Data 

0) . 23 
Words 3 through n+2 contain instructions or constants (where 1 < n < 24) 

Word n+ 3 

Load Load address relocation word (present iff (M) n 1= 1) 
0) 23 
Word n+ 4 

Common Blank common relocation word (present iff (M) N 2= 2) 
0 23 
Word n+ 5 

Programmed Programmed operator relocation word (present iff (M) n 4= 4) 

Operator 

Relocation {CS 
0 23 
Word n+ 6 

ve Special Input/Output operation relocation (present iff (M) 1 8 = 8) 

PGS hs Mace rn Se ee 


0 23 


Words n + 3 through n + 6 are modifier words. Each bit in each of these words corresponds to a data 
word; that is, bits 0 through 23 of each modifier word correspond to data words 3 through n + 2 
(where 1 Sn <= 24). A bit set to 1 in a modifier word indicates that the specified data word requires 
modification by the loader. There are four types of modification (and hence four possible modifier 
words) which are indicated in data records. Presence of a modifier word in a data record is indi- 
cated by the M (data word modifier) field in the load address word. 


The load address is subject to modification as indicated by the A field of the load address word as 
follows: 


(A) = 0, absolute. 

(A) N1= 1, current load relocation bias is added to load address. 

(A) N2= 2, current common relocation bias is added to load address; 
the remaining bits of A are unassigned. 


(A) = 3, illegal. 


EXTERNAL REFERENCES AND DEFINITIONS, BLOCK AND PROGRAM LENGTHS (T = 1) 
(Includes labeled COMMON, blank COMMON and program lengths) 


Word 1 
Control 
Word 
* From 1 to 10 items per record 
1- to 8-Character Label 
Common 
Length 
or Program 
Length Length Word 
Item 
a fe Length of Program or Common Block (L) 
0 12 6° 8. Oe 23 
B = 1 if (L) is program length 
C = 1 if (L) is length of a labeled common block 
l- to 8-Character Label 
0 5 6 11 12 17 18 23 
External 


Reference Chain Word 


Item Y 
Item Address Mod- 
en YY ifiers (A)** Address of Last Reference 


Co WZ 45 Bio? 23 


** See data record, load address word, for interpretation. 
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l- to 8-Character Label 


External 
Definition Value Word 
Item 


** See data record, load address word, for interpretation 


External symbolic definitions include subroutine "identification" as a subset and require no special 
treatment of subroutines with multiple names. 


1- to 8-Character Label 


External 

Reference ee. 
with a a 
Addend 

Word* 


Addend Word 


eT ee 


000 000 000 
0 og 23 


* One of these items for each unique reference; e.g., each of the following 
references is represented by a separate item: 


A+5, B+5, B+6, C +2, C+5 


** See data record, load address word, for interpretation. 


PROGRAMMED OPERATOR REFERENCES AND DEFINITIONS (T = 2) 


Word ] 

Control Record Vy) Mode 

Word Type (T) Y A=C =3|"* (Binary) Folded Checksum 
ee ee 
0 7 ae ae S79 11°12 23 


** From 1 to 10 items per record 


1- to 8-Character Mnemonic 


Internal 
Programmed 
Operator 


Programmed 
Operator 
Reference 


External 
Programmed 
Operator 
Definition 


R= 1 iff origin of Programmed Operator Routine is relocatable. 
The sequence number indicates the order in which the definitions or references occurred 
in the source program. 


END RECORD (T = 3) 


Word ] 
/ 
Record Y) 2<C <4 Mode Folded Checksum 
Type (T) i) (Binary) 
pon pop fm 


Control 


Word 


Lanoth of 
weit! wil 


Program 


** See data record description for interpretation. 
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| 000 [000001 


Transfer 


Word 


000001 
0 23 8 


Transfer Address 


This may be followed by a relocation word as described above in "Data Record Format," paragraph 2. 


APPENDIX G. PROCESSOR DIAGNOSTICS 


This summary of processor errors is provided for convenience of reference. The user should refer to the 
applicable processor reference manual for a more complete discussion. 


META-SYMBOL (900 Series Only) 


The standard abort message is 
META-SYMBOL ERROR xx 


where xx has the following values: 


XX Interpretation 
O1 Insufficient space to complete encoding of input. 

02 Corrections to encoded deck but encoded input file is empty. 

03 End of file detected while reading encoded input. 

04 Insufficient space to complete preassembly operations. 

05 Insufficient space to complete the assembly. 

06 Data error. META-SYMBOL does not recognize the data as anything meaningful. 

07 Requested output on a device which is not available. 

08 Corrections out of sequence. 

09 End of file detected by ENCODER when trying to read intermediate tape X1. 

10 Request for non-existent system procedures. 

11 Byte larger than dictionary (bad encoded deck). 

12 Not encoded deck. 

13. Checksum error reading system tape. 

14. Preassembler overflow (ETAB). 

15 Not used. 

16 Data error causing META-SYMBOL to attempt to process procedure sample beyond end of table. 
18 Improperly formatted or missing PROC deck series-specification card. 

24 Shrink overflow. 


Errors 05, 06, and 16 are accompanied by a printout that shows the value of certain internal parameters 
at the time of the abort: 


LINE NUMBER yyyyy 
BREAK 1] yyyyy 
LOCATION COUNTER _ yyyyy 
UPPER yyyyy 
LOWER yyyyy 
BREAK yyyyy 
SMPWRD yyyyy 
LTBE yyyyy 


second pass onl 
LTBL | : 


(yyyyy represents the value of the particular item). The last six of these are useful in determining the 
nature of the assembler overflow. 


After the appropriate message has been typed, control is transferred to MONARCH. 
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1/O ERROR MESSAGES AND HALTS 

When an I/O error is detected, a simple message is typed and the computer halts. The message consists 
of a 2-letter indication of the type of error and a 2-digit indication of the I/O device. The letter 
indicators are defined below; the 2-digit number is the unit address number used in EOM selects (see 


applicable computer reference manual). The action taken if the halt is cleared depends upon the type 
of error and the device involved. There are three types of error. 


BUFFER ERROR (BE) 
1. Examples: 


BE11 buffer error while reading magnetic tape |. 
BE52 buffer error while writing magnetic tape 2. 


2. Action upon clearing the halt: 


a. Magnetic tape input - since ten attempts are made to read the record before the halt occurs, 
continuing causes META-SYMBOL to accept the bad record. 


b. Paper tape or card input - try again. 

c. Magnetic tape output - try again. 

d. Output other than magnetic tape - continues. 
CHECKSUM ERROR (CS) | 
1. Examples: 


CS06 checksum error card reader. 
CS11 checksum error reading magnetic tape |. 


2. Action upon clearing the halt: 
Accepts bad record. 

WRITE ERROR (FP) 

1. Example: 
FP12 magnetic tape 2 file protected 

2. Action upon clearing the halt: 
Checks again. 


SYMBOL 


Input/output errors during a SYMBOL assembly result in a halt with the relative location of the halt 
displayed in the P register. The recovery procedure depends upon the type of error and the device 
involved. 


1. Paper tape reader or typewriter symbolic input - Upon deduction of a buffer error, a halt occurs 
with relative location 032 displayed in the P register. To continue the assembly, one can branch 
to relative location 025. To reread the record, one must reposition the paper tape and branch to 
relative location 03. 


2. Magnetic tape input - Input records are required to be card images (20 words). A premature 
termination is treated as being equivalent to an end of file. One end-of-file mark is allowed to 
separate input files on a tape reel and is ignored by the assembler at the beginning of the first pass. 
An additional end-of-file mark or one occurring after the first symbolic line but before the END 
line causes a halt in relative location 050. Clearing the halt causes a branch to location 01, which 


returns control to MONARCH. 


In case of tape read errors, ten recovery attempts are made after which a halt occurs in relative 
location 021. Clearing the halt causes the record to be accepted. 


3. Line printer listing - In the event of a printer fault, a halt occurs in relative location 023. To con- 
tinue the assembly, clear the fault on the printer and then clear the halt. 


FORTRAN II (900 Series Only) 


Both the FORTRAN II compiler's input/output error messages and the FORTRAN loader's error messages 
are listed here. 


I/O ERROR MESSAGES 


For input and output, FORTRANuses MONARCH's I/O handlers. If an error occurs during input or out- 
put, the compiler produces an error message of the form . 


FORTRAN I/O ERROR x 


x Interpretation 


1 An error has been detected during listing. Compilation continues. 


2  Anerror has been detected while reading magnetic tape. The message is output after ten un- 
successful read attempts. Compilation continues using the result of the last read. 


3 An error has been detected while punching or writing the object program. Output is sup- 
pressed, and compilation continues. : 


4 No input device has been assigned. This is an irrecoverable error, and control is transferred 


to MONARCH. 


These messages are printed onwhatever listing device has been assigned. If no listing device has been 
assigned, the messages are not printed, but the indicated action is still performed. 


There are three halts in the compiler. All display a flagged NOP in the C register with either a 7g or 
70g as an address. 


Address Interpretation and Action 
7 The computer will halt before reading paper tape for the first time, when a stop code 


has been read, or when tape gap has been detected. Clearing the halt will allow 
compilation to continue. 


70 An error has been detected while reading cards or paper tape. Clearing the halt will 
allow compilation to continue. 


FORTRAN II LOADER ERROR MESSAGES 


The error messages of the FORTRAN II loader running under MONARCH are as follows: 


Message Interpretation and Action 
ERROR SWITCH SET MONARCH is in the job mode (see JOB control message 


in Section 2), and the processor error switch has been set. 
Control is returned to MONARCH, which then attempts to 
read another control message. 


On 
N 


Message Interpretation and Action 


PROGRAM TOO BIG The program being loaded exceeds available memory. 
Loading continues, assuming an infinite memory. When 
loading is finished, the program size is typed out, and 
control is transferred to the MONARCH bootstrap. 


READ ERROR, RELOAD LAST RECORD _ The message is typed out, and the computer halts. Clearing 
the halt allows loading to continue. This message is caused 
by 
1. Card read error. 


2. Paper tape read error. 


3. Magnetic tape read error (ten attempts have been made 
to read the record). 


4, Checksum error. 
ILLEGAL INPUT, RELOAD PROGRAM __ This message is typed out, and control is transferred to the 
MONARCH bootstrap. This message can be caused by 
1. 12 interrupt while reading paper tape. 
2. Input which is not a legal subprogram. 
3. FOR RAN program heading improperly blocked. 
4 


Number less than 200g or greater than 244g assigned to 
a system subroutine reference. 


| Ge a Em PEIN ( 
crror in Checkin 


Cn 


g 
6. Labeled COMMON which is not accepted by the 
FORTRAN loader. 


7. First word in a record not being a control word. 


Type 0 records for POP relocation and special I/O re- 
location, type 2 records (POP references and defini- 
tions), illegal records (types 4 through 7), and external 
references with addend items which are not accepted by 


the FORTRAN loader. 


EOF STOP (Can occur only when FORTRAN linking is used. See Appendix 
E.) The requested link cannot be found on the link tape. The 
computer halts with the link number for which the search was 
unsuccessful displayed in the A register. Clearing the halt 
will cause the search to be repeated, 


Characters Internal Card BCD Code on Characters Internal 

” -pewriter Printer SDS Code Code Magnetic Tape Typewriter Printer SDS Code 
g 0 00 0 12 = ‘ 40 
1 l 01 ] 01 J J 4l 
2 2 02 Z 02 K K 42 
3 3 03 3 03 L L 43 
4 4 04 4 04 M M 44 
5 5 05 5 05 N N 45 
6 6 06 6 06 O O 46 
7 7 07 7 07 P P 47 
8 8 10 8 10 Q Q 50 
9 9 1] 9 1] R R 31 
Space Blank 12 8-2 12°) Car. Ret. (0) (©) 52 
# or = = 13 8-3 13 $ $ 53 
@or' : 14 8-4 14 * * 54 
15 8-5 15 } j 55 
> 16 8-6 16 ; ; 56 
v 17 8-7 17 A A 57 
& or + + 20 12 60 6 Blank 60 
A A 21 12-1 61 / Z 6] 
B B OR: 12-2 62 Ss S 62 
C C 23 12-3 63 T T 63 
D D 24 12-4 64 U U 64 
E E 25 12-5 65 Vv Vv 65 
F F 26 12-6 66 W W 66 
G G 27 12-7 67 x Xx 67 
H H 30 12-8 70 Y Y 70 
I I 31 12-9 7\ z 7 
eckepace’o gle) 32 12-09) 72 fang? ; (e) 72 
33 12-8-3 73 . , 73 
NM or ) ) 34 12-8-4 74 % or ( ( 74 
[ 35 12-8-5 75 i. ase) 75 
< < 36 12-8-6 76 \ \ 76 

# Stop + (©) 37°) 12-8-7 77 # Delete Pe 77) 
NOTES: 


APPENDIX H. SDS CHARACTER CODES 


The characters ? !| and ¢ are for input only. The functions Backspace, Carriage Return, or Tab always occur on output. 


On the off-line paper tape preparation unit, 37 serves as a stop code and 77 as a code delete. 


The internal code 12 is written on tape as a 12 in BCD. When read, this code is always converted to 00. 


The codes 12-0 and 11-0 are generated by the card punch; however, the card reader will also accept 12-8-2 for 32 and 


11-8-2 for 52 to maintain compatibility with earlier systems. 


For the 64-character printers only. 


BCD Code on 
Magnetic Tape 


40 
4] 
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Action subroutines, 15 

ALGOL, 5, 7 

ALGOL compiler, 1, 7, 16 
equipment configuration, 2 
source deck structure, 33 

ALGOL loader, 10 

ALGOLOAD, 5, 10 

ASSIGN, 5, 15, 41 


BACKFILE, 5, 12 
BACKREC, 5, 12 
Batch processing, 1, 34 


Blank COMMON references and definition, 16 


Blocking mode, 23 
BOOTLOAD, 5, 13 
Bootstrap, 1, 8, 13, 15, 16 
Bootstrap loader, 1, 15, 16 


Business Language Assignment Table (BAT), 5, 39 


oe ae 


C, 3, 5, 10, 35 

Card read/punch subroutine, 15 

CARDTAPE, 5, 13 

CDRP, 15 

Character Set, 69 

COMMON relocation, 48 

Control messages, 3 
ALGOL, 5, 7 
ALGOLOAD, 5, 10 
ASSIGN, 5, 15, 41 
BACKFILE, 5, 12 
BACKREC, 5, 12 
BOOTLOAD, 5, 13 
C;.. 3,5, 10,35 
CARDTAPE, 5, 13 
DISPLAY, 5, 11 
ENDJOB, 5 
EOF, 5, 13 
FILLSYS, 5, 8 
FORTLINK, 5, 9, 55 
FORTLOAD, 5, 9 
FORTRAN, 5, 7 
JOB, 5 
LABEL, 5, 10 
LOAD, 5, 8, 15 
METAXXXX, 5, 6 
ONLINE, 5 
POSITION, 5, 11 
REWIND, 5, 12 
SET, 5, 10 
SHOW, 5, 11 
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INDEX 


Control messages (cont. ) 
SKIPFILE, 5, 12 
SKIPREC, 5, 12 
SYMBOL, 5, 7 
UPDATE, 5, 14 
WEOF, 5, 12 

COPY, 23, 24, 25 


ae 9 fee 


Data records, 18, 48, 59 
Decimal integer, 4 
Diagnostics 
FORTRAN II, 67 
META-SYMBOL, 65 
MONARCH, 37 
SYMBOL, 66 
DISPLAY, 5, 11 


abe 


ENDJOB, 5 

End-of-file (EOF) mark, 12 
End record, 63 

EOF, 5, 13 

Equipment configuration, 1 
Error switch, 1, 5, 9, 15, 39 


External label references/definitions, 16, 18, 19, 49, 61 
External POP references/definitions, 16, 18, 19,50, 6z 


ay a 


FILLSYS, 5, 8 
Format of control messages, 3 
FORTLINK, 5, 9, 55 
FORTLOAD, 5, 9 
FORTRAN, 5, 7 
FORTRAN II compiler, 1, 7, 16 
equipment configuration, 2 
error messages, 58 
linking, 9, 54 
source deck-structure, 30 
FORTRAN loader, 9, 37 
Functions of MONARCH, 2 


Furnishing control messages, 35 


no ee 


Halts (MONARCH program), 36, 37 


 - 


Input control messages, 5, 8 
ALGOLOAD, 5, 10 
FILLSYS, 5, 8 
FORTLINK, 5, 9, 55 


Input control messages (cont. ) 
FORTLOAD, 5, 9 
LOAD, 5, 8, 15 

I/O device specification, 4, 5 

I/O subroutines (standard), 15, 17, 39 


Site 


JOB, 5 
Job mode, 5 
Job switch, 1, 5, 9, 15, 39 


ee 


LABEL, 5, 10 
Level 1/2 ID records, 8, 10, 11, 22, 24 
Library (MONARCH), 16, 17 
Loading from, 18 
Line printer output subroutine, 15, 17, 20 
Linking (FORTRAN), 9 
Linking process (FORTRAN), 54 
Literal parameters, 4 
LOAD, 5, 8, 15 
Loader, 1, 8, 15, 16, 21, 48 
Loading the MONARCH system, 35 
Load relocation, 48 


-M- 


Magnetic tape I/O subroutine, 15 
Memory allocation, 17, 43 
Memory dump routine (see Octal Dump Routine) 
META-SYMBOL assembler, 1, 6, 15, 16 
equipment configuration, | 
error messages, 65 
source deck structure, 29 
updating of, 53 
METAXXXX, 5, 6 
MONARCH 
bootstrap, 1, 8, 13, 15, 16 
ID records, 8, 10, 11, 22, 24, 42 
library, 16, 17, 18 
loader, 1, 8, 15, 16, 21, 48 
system, 1, 15, 42 
Monitor, 1, 3, 15, 16 
MTAPE, 15 


Numeric parameters, 3 
a @ we 


Octal correction routine, 20 
Octal dump routine, 1, 15, 20 
Ocial integer, 3 

ONLINE, 5 

Operating environment, | 
Operating procedures, 35 


mn oe 


Paper tape/typewriter I/O subroutine, 15 
Parameters of control messages, 3 
literal, 4 
numeric, 3 
symbolic, 4 
POP relocation, 48 
POSITION, 5, 11 
Preparing program decks, 29 
ALGOL, 33 
batch processing, 34 
FORTRAN II, 30 
META-SYMBOL, 29 
PRINT, 15 
Program, 17 
Processor control messages, 5, 6 
ALGOL, 5, 7 
FORTRAN, 5, 7 
METAXXXX, 5, 6 
SYMBOL, 5, 7 
Processor error switch (see Error Switch) 


PTYIO, 15 
mee ae 


QBINI, 17, 40 
QBINO, 40 
QBOOT, 15 
QDUMP, 15, 20 
QMSG, 17, 22, 40 
QPESW, 39 
Q35YMO, 23, 40 
QSYS, 23, 40 
QSYSI, 40 
QSYSLDR, 21 
QSYSP, 40 
QSYST, 22, 40 
QSYSU, 22, 40 


Recovery procedure, 37 

Relocation and data records, 18, 48 
Resident, 1, 15, 16 

Restart procedure, 16 

REWIND, 5, 12 


Ge 


Search subroutine, 11, 15 
Separators, 3 

SET, 5, 10 

SHOW, 5, 11 

SKIPFILE, 5, 12 

SKIPREC, 5, 12 

Special I/O relocation, 49 
Standard binary language, 16, 59 
Standard system routines, 15 
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Storage allocation, 17, 43 Update routine (cont. ) 


SYMBOL, 5, 7 deletion, 24 
SYMBOL assembler, 1, 7, 16 insertion, 23 
equipment configuration, | replacement, 24 
error messages, 66 retention, 24 
Symbolic parameters, 4 UPDATE, 5, 14 
Symbol table, 8, 17, 37, 51 update file, 23 
Symbol table typeout routine, 15, 17, 20 updating META-SYMBOL, 53 
Syntax of control messages, 3 Utility functions messages, 5, 10 
System control messages, 5 BACKFILE, 5, 12 
ASSIGN, 5, 15, 41 BACKREC, 5, 12 
ENDJOB, 5 BOOTLOAD, 5, 13 
JOB, 5 Cy 35-57-10). 35 
ONLINE, 5 CARDTAPE, 5, 13 
System maintenance messages DISPLAY, 5, 11 
UPDATE, 5, 14 EOF, 5, 13 
System output, 37 LABEL, 5, 10 
POSITION, 5, 11 
-T- REWIND, 5, 12 
SET, 5, 10 
Tape search routine, 11, 15 SHOW, 5, 11 
Termination of arun, 16 SKIPFILE, 5, 12 
TYPSY5, 20 SKIPREC, 5, 12 
WEOF, 5, 12 
Sy & 
aie 
ree table (UAT), 1, 15, 17, 39 Valoesee caranisten. 4 
Update routine, 1, 15, 22 ape 


| Ie / i 1 59 
piocking/normal mode, Zo 


COPY message, 23, 24, 25 WEOF, 5, 12 
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